Chef/GettingStarted
This page serves as a getting started guide for community members interested in contributing to the OpenStack Chef cookbooks and example repository.
Contents
Communication
- The OpenStack + Chef community has a mailing list on Google Groups. Join the conversation: https://groups.google.com/forum/?fromgroups=#!forum/opscode-chef-openstack
- There is an #openstack-chef channel on Freenode.net. Come hang out with us and collaborate there.
Bug Tracking
We track bugs and feature requests using a single Launchpad project called OpenStack + Chef. You can see the list of open bugs or file a new bug.
Blueprints / Feature Tracking
For major feature enhancements and planning you can use Launchpad's Blueprints system for the OpenStack + Chef project on Launchpad. You can create a new blueprint that may be targeted to a milestone and tracked appropriately. The process for blueprint content reviews is documented here: https://github.com/stackforge/openstack-chef-specs
Code
The canonical upstream Chef cookbooks and example repository are located in the Stackforge Github organization. There is a single Chef cookbook for each integrated OpenStack project:
- OpenStack Bare Metal (Ironic) cookbook
- OpenStack Block Storage (Cinder) cookbook
- OpenStack Compute (Nova) cookbook
- OpenStack Dashboard (Horizon) cookbook
- OpenStack Data Processing (Sahara) cookbook
- OpenStack Database (Trove) cookbook
- OpenStack Identity (Keystone) cookbook
- OpenStack Image (Glance) cookbook
- OpenStack Network (formerly known as Quantum) cookbook
- OpenStack Object Storage (Swift) cookbook
- OpenStack Orchestration (Heat) cookbook
- OpenStack Telemetry (formerly known as Metering) (Ceilometer) cookbook
In addition to the project cookbooks, there are five support cookbooks:
- Common library cookbook
- Example database configuration cookbook
- Example message queue configuration cookbook
- OpenStack Integration Test Suite (Tempest) cookbook
- A distributed network storage and filesystem (Ceph) cookbook
As well as an example Chef Repository that sets up an OpenStack environment:
Releases
The following table show the supported openstack releases and platforms. Note that some of the cookbooks do not support all the platforms, see the Readme's and metadata files for more information.
Branch | Status | Platforms |
---|---|---|
Grizzly | stable - frozen | Ubuntu 12.04 |
Havana | stable - frozen | Ubuntu 12.04, RedHat 6.5, Suse 11.03 |
Icehouse | stable - fixes | Ubuntu 12.04, RedHat 6.5, Suse 11.03 |
Master - Juno | development | Ubuntu 14.04, RedHat 7 |
Kilo | TODO Begin Feb 2015 | Ubuntu 14.04, RedHat 7, Suse 11.03 |
Release branching work items page
How to Contribute
We have broken this off into another page here.