How to start

This is a quick start guide to use Master-Chef with ec2 instances (only on eu-west-1).

Create instance from official AMI

• Debian 6 squeeze
• Debian 7 wheezy
• Ubuntu 10 lucid
• Ubuntu 12 precise

You can click on link above to create instance, using your private key pair.

Bootstrap master-chef

Clone master-chef :

git clone git://github.com/kitchenware/master-chef.git

Bootstrap master-chef :

For debian

cat bootstrap.sh | ssh admin@INSTANCE_IP bash

For ubuntu

cat bootstrap.sh | ssh ubuntu@INSTANCE_IP bash

This script create a chef account, deploy your ssh key in this account, and bootstrap master-chef.

Enjoy master-chef

SSH the instance

ssh chef@ip_of_created_instance

Run master-chef

/etc/chef/update.sh

How to configure it ? All the master-chef is in the file /etc/chef/local.json. Re-run /etc/chef/update.sh after each local.json modification.

You can find lot of examples here. The description of what these config do is here.

Just one example

A local.json file to install Jenkins.

{
  "repos": {
    "git": [
      "git://github.com/kitchenware/master-chef.git"
    ]
  },
  "run_list": [
    "recipe[base::system]",
    "recipe[master_chef::chef_solo_scripts]",
    "recipe[jenkins]"
  ],
  "node_config": {
  }
}

Easy, is'nt it ?

License

Copyright 2012 Bertrand Paquet / Octo Technology

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.