A self-contained, full-stack cookbook development toolchain for Chef!
The current version of the Chef Utensils toolchain is bundled with:
- Ruby 1.9.3
- Chef 11 (
knifeandchef-shella Chef developers best friends) - Berkshelf (cookbook dependency management; it's like Bundler for your cookbooks)
- Foodcritic (A lint tool for your cookbooks.)
- Test Kitchen 1.0 (née Jamie-CI; multi-platform integration testing made easy)
Additionally the following Knife plugins are included:
- knife-ec2
- knife-openstack
- knife-rackspace
Creating an Omnibus-powered Chef Utensils package is easy! Assuming you have a sane Ruby development environment configured, run the following commands on the platform you want to build a package for:
bundle install --binstubs
cp omnibus.rb.example omnibus.rb
sudo mkdir -p /opt/chef-utensils /var/cache/omnibus
sudo chown $USER:staff /opt/chef-utensils /var/cache/omnibus
bundle exec omnibus build chef-utensils
This repository also ships with a Vagrantfile which makes it easy to build packages for most major Linux distributions. Simply uncomment out the appropriate Vagrant box entry in the Vagrantfile and run:
bundle install --binstubs
bundle exec vagrant up
No matter the method you choose, once your build is complete you should have
a shiny new platform-specific package sitting at $PWD/pkg. Take that package
and share with your friends and co-workers. Ideally you would build these
packages in some sort of CI infrastructure and have build slaves for each
platform you want to support.
Rough build vs install compatibility matrix for Linux distributions:
| Build Platform | Compatible Install Platforms |
|---|---|
| Ubuntu 10.04 64-bit | Ubuntu 10.04, 10.10, 11.04, 11.10 64-bit |
| Ubuntu 12.04 64-bit | Ubuntu 12.04, 12.10 64-bit |
| CentOS 5 64-bit | RHEL 5 derivatives (Fedora, Amazon, Scientific) |
| CentOS 6 64-bit | RHEL 6 derivatives (Fedora, Amazon, Scientific) |
| Mac OS X 10.8.2 64-bit | Mac OS X 10.8.2 64-bit (Mountain Lion) |
Additionally packages created on Ubuntu should install on Debain. The above matrix is based on known compatibility from Chef Omnibus packages.
- Windows MSI support
- Add support for installing to user home directory (ie ~/chef-utensils )
- Add support to prompt, download and install Vagrant full-stack installer
- Add support to prompt, download and install VirtualBox
- Help user setup initial knife.rb file
- Add acceptance tests to ensure all packaged utilities play nicely with each other.
| Author | Seth Chisamore (schisamo@opscode.com) |
| Copyright: | Copyright (c) Seth Chisamore |
| License: | Apache License, Version 2.0 |
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.