kitchen server

... a server's kitchen.

It configures a vanilla server for your development needs. This is a collection of useful cookbooks with configuration.

set up users and user configuration + roll out ssh keys
set up ruby 1.9 and gems
virtualbox
vagrant with plugins: berkshelf
librarian-puppet (incl. puppet client)
core packages (curl, htop)

Optional components:

set up zsh with oh-my-zsh and themes per user
set up gitconfig (incl. git shortcuts) per user
extra packages (colordiff, 7z)

Requirements

knife-solo gem

Installation:

gem install knife-solo

It is currently only tested with Ubuntu 12.04.

Kickstart

For the impatient, install with default settings:

./setup.sh ubuntu@192.168.200.204

Or use the extended configuration:

./setup.sh ubuntu@192.168.200.204 ext

The Gist, if you prefer to do it yourself:

host='192.168.200.204'
sshkey=$(cat ~/.ssh/id_rsa.pub)

cp nodes/example.json nodes/$host.json
sed 's~.*ssh_keys.*~"ssh_keys":["'${sshkey}'"]~' -i data_bags/users/example.json
knife solo bootstrap ubuntu@$host

# and profit:
ssh knife@$host

Usage and Configuration

Convention: replace mynode with either your node's IP address or hostname.

Configure your node. You can use nodes/example.json as a starting point:
```
 cp nodes/example.json nodes/mynode.json
```

Now edit nodes/mynode.json:

    {
      "users": [
        "ubuntu"
      ],
      "run_list": [
        "role[vagrant]"
      ]
    }

Configure users in data_bags/users/. You can use example.json to get started:
```
 cp data_bags/users/example.json data_bags/users/ubuntu.json
```

Now edit data_bags/users/ubuntu.json. Don't forget to add your ssh public key so you can log in with the user:

    {
      "id"            : "ubuntu",
      "comment"       : "Mr. Ubuntu",
      "home"          : "/home/ubuntu",
      "groups"        : ["admin"],

      "ssh_keys"      : [
        "ssh-rsa AAAAB3..."
        ]
    }

Install
```
 knife solo bootstrap ubuntu@mynode
```

To update your server:

    knife solo cook ubuntu@mynode

You may refer to the knife-solo documentation for help.

If you want the optional components, please refer to nodes/example_ext.json and data_bags/users/example_ext.json.

Vagrant

You can try it out via Vagrant:

vagrant up
PORT=9922 PASSWORD=vagrant ./setup.sh vagrant@localhost

Contributing

Fork the repository on Github
Create a named feature branch (like add_component_x)
Write you change
Write tests for your change (if applicable)
Run the tests, ensuring they all pass
Submit a Pull Request using Github

License and Authors

Authors: Dominik Richter dominik.richter@googlemail.com

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.