TL;DR: Install chef-server automatically with one command.
When it comes to sys-admin - I make a very good software developer, because quite frankly repetitive tasks are not my cup of tea.
So when it came to setting up and managing a cluster of servers for my startup I immediately looked at Chef, and on paper it looked like it would fit the bill perfectly - I can write all the components, store them on Github and it will take care of all the hard work on each server.
Then I got slapped in the face by the monstrosity that is the Chef installation guide. What? No
gem install chef and you're done? this needed to be fixed, so I wrote
a Babushka dependency to take care of everything.
Babushka is a test-driven system administration tool written by Ben Hoskings, it uses an omnipotent approach to configure your servers by running dependencies - "deps" - written in a familiar Ruby DSL.
If you've ever been in charge with installing chef-server by hand you will know it requires some work, and has the potential to break very easily. If you have trouble installing one version you have to ditch your instance and start from scratch, or spend considerable time reversing changes.
To solve this problem I wrote a collection of Babushka deps to do this job for us, and it even allows you to specify a version on the fly.
It assumes you have a bare Ubuntu instance (Tested on 10.04) running somewhere with root access over ssh. While there is no real requirement for it to be bare, these deps will customise things considerably so it is advisable to use a dedicated instance for this setup.
So lets get into it, you'll need to meet these minimum requirements if following on at home:
root(Don't worry we will disable it again later)
Once you have created an instance, login as
root and run through these steps:
wget if not already installed:
apt-get install wget
Bootstrap Babushka using Babushka:
bash -c "`wget -O - babushka.me/up`"
Follow the default prompts and you should be good to go.
Next we run my
'chef user' dep:
babushka ivanvanderbyl:'chef user'
Notice how we don't have to tell Babushka where to get it from? By default Babushka looks for a Github repository called
<GITHUB USERNAME>/babushka-deps.git and clones it, then loads it into its internal list.
My babushka-deps repo contains the dep
This will run the list documented below, and towards the end create a new user account which you will use in the next step to install and manage chef from.
Make sure you don't call the user
chef because it will cause things to fail in the next step. I usually use
Now logout from root and reconnect as the chef user you just created to complete the next step: actually installing chef-server.
This is where the magic happens, run this dep and you will have a complete Chef Server installation, optionally with chef-server-webui
babushka ivanvanderbyl:'bootstrapped chef'
This will verify that all services have started correctly and if so report success, otherwise it will output a log file so you can trace what happened and hopefully fix the problem. (Please report bugs with this process below)
If all components are installed correctly it will register this node with chef-server by running knife configure -i automatically.
You might think installing chef-server is a simple bootstrap command documented on the Chef Wiki. This is partially true, until you spend considerable time setting hostnames, creating users, uploading public keys, disabling root, installing default software and extensions, and not to mention installing Ruby and Rubygems from source.
So these deps take care of all of this. Here's a run list:
babushka ivanvanderbyl:'chef user' - run this as
admingroup and adds it to sudoers list
After this you should logout from root and login as this user (
deploy by default)
babushka ivanvanderbyl:'bootstrapped chef' - run this as the user created in the above step (
deploy by default)
chefgem with the version you specify
You could complete the chef setup as per the Rubygems Chef Bootstrap guide or enlist the pro-skills of Babushka again, in which case; read on.
From the Chef Wiki: When working with chef, you will spend a lot of time editing recipes and other files, and you'll find it much more convenient to edit them on your laptop/desktop, where you have your editor configured just to your liking. To facilitate this mode of working, we recommend you create a knife client to use knife on your development machine.
I've also created a dep for this, simply run (on the server):
babushka ivanvanderbyl:'external admin client.registered'
This will register a new client for you to use locally, which means you need to copy this new client's private key to your laptop/desktop. The command for this is: (on your laptop/desktop)
mkdir ~/.chef scp email@example.com:/tmp/my-username.pem ~/.chef/my-username.pem
chef.example.com with the FQHN of your chef server, and replacing
my-username with the username you entered when running
external admin client.registered
Note: If you haven't installed the chef gem locally please do so now
gem install chef
Configure knife locally:
your-laptop > knife configure No knife configuration file found
Knife looks for its configuration in ~/.chef/knife.rb by default:
Where should I put the config file? [~/.chef/knife.rb] Please enter the chef server URL: [http://localhost:4000] http://chef.example.com:4000
Now, enter your client name, exactly as you did when running
'external admin client.registered' above:
Please enter an existing username or clientname for the API: [my-username] my-username
For these next settings, you can accept the defaults for now and update them later by editing your knife.rb file. The validation client name and key are used with knife's cloud computing commands:
Please enter the validation clientname: [chef-validator] Please enter the location of the validation key: [/etc/chef/validation.pem]
your-laptop > knife client list [ "chef-webui", "my-username", "bob", "chef-validator" ]
You will need to bootstrap each new server you add to your cluster, this is similar to the process above however it does not depend on running as root, however if you are starting with the same image
it is recommended that you run the
chef user dep first and login as that user before bootstrapping as a client. This is a more secure approach.
To bootstrap this server as a client, simply run:
babushka ivanvanderbyl:'bootstrap chef client'
Alternatively you can do all these steps manually using the Chef Wiki guide on Bootstrapping a new client with Rubygems
Now we need to set up the client so it is authenticated to talk to the server. This is done by creating a certificate pair.
To do this, you will need to copy the file
/etc/chef/validation.pem from the chef server to your chef client into the same path. This might seem a little tricky given that we have disabled password login, so I would recommend a simple
⌘C + ⌘V approach.
Then, simply run
sudo chef-client and it will register itself with your chef server. After it is done, be sure to delete the file /etc/chef/validation.pem on your client! (It is the key to the universe)
You now have a complete Chef server setup, it is now time to write some cookbooks and install software; for this I will hand you over to the Chef Guides until I write something on this at a later date.
I encourage you to contribute to these deps, if you find a bug, or you want to add support for another linux distro please fork my Babushka deps repo.