Project

dbagger

0.0
No commit activity in last 3 years
No release in over 3 years
dbaggerpaulczar/dbaggerHomepageDocumentationSource CodeBug TrackerWiki
Command line tool to fetch user details including keys from the github API and transform into a Chef Databag usable by the Chef Users cookbook.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
9,737
Stars
0
Forks
1
Watchers
4
 Releases
Current version
0.1.2
Total releases
3
First release
2013-12-12
Latest release
2013-12-12
 Development
Primary Language
Ruby
Licenses
apache2
Average date of last 50 commits
2013-12-12
Reverse Dependencies
0

 Dependencies

Runtime

rest-client
~> 1.6.7
 Project Readme

dbagger

dbagger is a ruby gem that will look up a user in the github API and create a databag that be be used by the Users Cookbook to manage users on Chef configured servers.

simply pass it the github username of the user and the groups you want them to be part of and it will print an appropriate databag to STDOUT which can be added to chef using the knife command including their SSH keys.

Usage

Install

gem install dbagger

CLI

Usage: dbagger -u <username> -g <group1,group2>

Options
    -u, --username USERNAME          Username you want to create
    -l, --gh-login USERNAME          Github username if different to --username
    -g, --groups GROUP1,GROUP2       Comma seperated list of groups to add user to
    -s, --shell '/bin/bash'          defaults to '/bin/bash' if not set
    -a, --api github_API_URI         defaults to 'https://api.github.com' if not set
    -p, --password $1$XXXXXX         encrypted password.  If left blank will set to '*'
    -h, --help                       help

examples

Basic

$ ./dbagger -u dirtyharry -g cop,human

{id":"dirtyharry","ssh_keys":["ssh-rsa AAAAB3N.../sn+j"],"groups":["cop","human"],"shell":"/bin/bash","password":"*","comment":"Dirty Harry"}

Comprehensive

$ ./dbagger -u dirtyharry -g cop,human -l harry45 -s '/bin/zsh' -a 'http://github.lapd.com/api/v3' -p '$1$l7qLsKLx$0rVGl3CGEghjk6yo4KRXW0'

{id":"dirtyharry","ssh_keys":["ssh-rsa AAAAB3N.../sn+j"],"groups":["cop","human"],"shell":"/bin/zsh","password":"$1$l7qLsKLx$0rVGl3CGEghjk6yo4KRXW0","comment":"Dirty Harry"}

Use with knife

$ ./dbagger -u dirtyharry -g cop,human > /tmp/dirtyharry.json
$ knife data bag from file users /tmp/dirtyharry.json
Updated data_bag_item[users::dirtyharry]

Ruby

1.9.3-p448 :001 > require 'dbagger'
 => true
1.9.3-p448 :002 > Dbagger.collect_data(:username=>"dirtyharry", :groups=>["cop", "human"], :github_api=>"https://api.github.com", :shell=>"/bin/bash", :password=>"*", :gh_username=>"dirtyharry")
 => {:id=>"dirtyharry", :ssh_keys=>["ssh-rsa AAAAB3NzaC1yc2EAAAADAQAB...."], :groups=>["cop", "human"], :shell=>"/bin/bash", :password=>"*", :comment=>"Dirty Harry"}
 1.9.3-p448 :003 >

Testing

bundle install
bundle exec rake test

Report Bugs

use the github bugs thingy.

License and Author
Author Paul Czarkowski (paul.czarkowski@rackspace.com)
Copyright Copyright (c) 2013, Paul Czarkowski
Copyright Copyright (c) 2013, Rackspace

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.