omnibus Cookbook

Prepares a machine to be an Omnibus builder.

This project is managed by the CHEF Release Engineering team. For more information on the Release Engineering team's contribution, triage, and release process, please consult the CHEF Release Engineering OSS Management Guide.

Requirements

Chef

Chef 11.0.0+

Platform

Supported platforms by platform family:

debian (debian, ubuntu)
fedora
freebsd
rhel (centos, redhat, amazon, scientific etc.)
smartos
solaris2
windows

Cookbooks

This cookbook depends on the following external cookbooks:

apt (Opscode)
build-essential (Opscode)
git (Opscode)
homebrew (Opscode)
pkgutil (marthag)
rbenv (Riot Games)
yum (Opscode)
wix (Opscode)
7-zip (Opscode)

Recipes

The default recipe is the main entrypoint for the cookbook and does the following:

Ensures all required Omnibus-related directories are created and owned by the build user.
Ensures a sane build tool-chain is installed and configured (using the build-essential cookbook)
Ensures git is installed (using the git cookbook)
Includes a platform-specific recipe to apply additional tweaks as appropriate.

All other recipes should be treated as "private" and are not meant to be used individually. They only exist to support the default recipe.

Attributes

Attribute	Description	Type	Default
build_user	User Omnibus build will be performed as	String	omnibus
install_dir	Installation directory of the Omnibus package	String	/opt/omnibus
cache_dir	The directory the Omnibus project uses for caching	String	/var/cache/omnibus

Usage

Include the omnibus::default recipe in your node's run list and override the cookbook's default attributes as desired. At the very least you will want to override node['omnibus']['install_dir'] to match the installation directory of your Omnibus project.

Testing

You can run the tests in this cookbook using Rake:

rake integration  # Run Test Kitchen integration tests
rake style        # Run all style checks
rake style:chef   # Lint Chef cookbooks
rake style:ruby   # Run Ruby style checks
rake travis:ci    # Run tests on Travis

License & Authors

Author:: Seth Chisamore (schisamo@opscode.com)
Author:: Stephen Delano (stephen@opscode.com)

Copyright 2012-2013, Opscode, Inc. (<legal@opscode.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.

OpsRockin/omnibus