README.md

Opscode Public Cookbooks for Chef

This repository is the primary project source of Opscode's published, public cookbooks for Chef. This repository is considered "in development." Published cookbooks are shared by Opscode on the Chef Community Site.

Cookbooks in this repository are only ones maintained and supported by Opscode.

Contributing

While this repository is hosted on GitHub, we do not use pull requests as the primary mechanism or workflow for contributions.

When contributing changes to individual cookbooks, please do not modify the version number in the metadata.rb. Also please do not update the Changes section for a new version. Not all changes to a cookbook may be merged and released in the same versions. Opscode will handle the version updates during the release process. You are welcome to correct typos or otherwise make updates documentation in the README.

If a contribution adds new platforms or platform versions, indicate such in the body of the commit message(s), and update the relevant COOK ticket. Also include in the COOK ticket as a comment the log output of a successful Chef run, and the end state of the resources as they are configured on the target system, so we know that they work on the indicated platform.

For information on how to contribute, see the CONTRIBUTING file in this repository.

Opscode cookbooks are distributed under the Apache 2 Software License. See LICENSE.

Using this Repository

Opscode does not recommend that you use this repository directly, either as a submodule or as a "canonical" repository. Chef Cookbooks are "packages" for managing resources in your infrastructure, and there are as many ways to manage the various pieces of software provided here as there are different infrastructures. These cookbooks reflect our opinions about the best ways to manage these infrastructure components with Chef.

We recommend you install our cookbooks into your Chef repository from the Chef Community site, and uploaded to your Chef Server with the command-line tool "knife".

knife cookbook site install COOKBOOK
knife cookbook upload COOKBOOK

Use of this repository is recommended for developers who wish to contribute fixes to Opscode's cookbooks.

Bugs

Like any software, there may be bugs in our cookbooks. You can open a ticket in the COOK project at: