Chef-DK Cookbook

A cookbook for installing the Chef Development Kit.

Requirements

As of this writing, Chef-DK is available for RHEL/CentOS/etc. 6, Ubuntu
12.04/13.10, OS X 10.9.x, and Windows 7/8/2008/2012. Each of these platforms
is supported by this cookbook.

In some cases, platforms that aren't officially supported by Chef-DK may still
function. For example, this cookbook can be used to install the OS X package
onto 10.10 systems, or the Ubuntu package onto 14.04 systems.

This cookbook consumes the
dmg cookbook in order to
support OS X installs.

Usage

This cookbook can be implemented either by calling its resource directly, or
adding the recipe that wraps it to your run_list.

Recipes

default

Calls the chef_dk resource to do a package install

Attributes

default

Attributes are provided to allow overriding of the package version or URL the
default recipe installs:

default['chef_dk']['version'] = 'latest'
default['chef_dk']['package_url'] = nil

Resources

chef_dk

Wraps the fetching of the package file from S3 and the package installation
into a single resource:

chef_dk '' do
    version '1.2.3-4'
    package_url 'http://here.is.the/package/url'
    action :install
end

• version - An optional version to install (default is 'latest')
• package_url - An optional override package URL (default is determined at run time based on the OS and desired version)
• action - Action to perform (default is :install, also supports :uninstall)

Note: A version and package_url cannot be used together

Providers

This cookbook includes a provider for each of its supported platform families.
By default, the chef_dk resource will determine a provider to used based on
the platform on which Chef is running.

Chef::Provider::ChefDk

A generic provider of all non-platform-specific functionality.

Chef::Provider::ChefDk::Debian

Provides the Ubuntu platform support.

Chef::Provider::ChefDk::MacOsX

Provides the Mac OS X platform support.

Chef::Provider::ChefDk::Rhel

Provides the RHEL and RHELalike platform support.

Chef::Provider::ChefDk::Windows

Provides the Windows platform support.

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Run style checks and RSpec tests (bundle exec rake)
4. Commit your changes (git commit -am 'Add some feature')
5. Push to the branch (git push origin my-new-feature)
6. Create new Pull Request

License & Authors

• Author: Jonathan Hartman j@p4nt5.com

Copyright 2014, Jonathan Hartman

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.