Chef

DESCRIPTION:

Chef is a configuration management tool designed to bring automation to your entire infrastructure.

The Chef Wiki is the definitive source of user documentation.

• wiki.opscode.com/display/chef/Home

This README focuses on developers who want to modify Chef source code. For users who just want to run the latest and greatest Chef development version in their environment, see:

• wiki.opscode.com/display/chef/Installing+Chef+from+HEAD

DEVELOPMENT:

Before working on the code, if you plan to contribute your changes, you need to read the Opscode Contributing document.

• wiki.opscode.com/display/opscode/Contributing

You will also need to set up the repository with the appropriate branches. We document the process on the Chef Wiki.

• wiki.opscode.com/display/opscode/Working+with+Git

Once your repository is set up, you can start working on the code. We do use BDD/TDD with RSpec and Cucumber, so you’ll need to get a development environment running.

ENVIRONMENT:

In order to have a development environment where changes to the Chef code can be tested, we’ll need to install a few things after setting up the Git repository.

Non-Gem Dependencies

Install these via your platform’s preferred method; for example apt, yum, ports, emerge, etc.

• Git

• GCC and C Standard Libraries, header files, etc. (i.e., build-essential on debian/ubuntu)

• Ruby development package

Runtime Rubygem Dependencies

Chef Client and Solo

• bunny

• erubis

• highline

• json (1.4.4 - 1.4.6)

• mixlib-authentication

• mixlib-cli

• mixlib-config

• mixlib-log

• moneta

• rest-client

• uuidtools

• merb-core

• net-ssh

• fog

Development Rubygem Dependencies

• rake

• rspec

Spec testing:

We use RSpec for unit/spec tests. It is not necessary to start the development environment to run the specs–they are completely standalone.

rake spec

LINKS:

Source:

• github.com/opscode/chef/tree/master

Tickets/Issues:

• tickets.opscode.com/

Documentation:

• wiki.opscode.com/display/chef/Home/

LICENSE:

Chef - A configuration management system

Author

Adam Jacob (<adam@opscode.com>)

Copyright

Copyright © 2008, 2009 Opscode, Inc.

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.