Jump to: navigation, search

Difference between revisions of "Chef/GettingStarted"

(Communication)
(Update links)
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page serves as a getting started guide for community members interested in contributing to the OpenStack Chef cookbooks and example repository.
+
This page serves as a getting started guide for community members interested in introducing themselves to the OpenStack Chef cookbooks and community.
  
 
==Communication==
 
==Communication==
  
* The OpenStack + Chef community leverages the main openstack-dev mailing list with the tag of [chef] in the subject line.
+
* The OpenStack + Chef community leverages the main [http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-discuss openstack-discuss mailing list] with the tag of [chef] in the subject line.
* There is an '''#openstack-chef''' channel on Freenode.net. Come hang out with us and collaborate there.
+
* There is an [https://webchat.freenode.net/?channels=openstack-chef #openstack-chef channel] on freenode.net. Come hang out with us and collaborate there.
 +
* We have a maintainers list located [https://opendev.org/openstack/openstack-chef-specs/src/branch/master/MAINTAINERS.md here]. Please don't hesitate to reach out.
  
 
==Bug Tracking==
 
==Bug Tracking==
Line 13: Line 14:
  
 
For major feature enhancements and planning you can use Launchpad's Blueprints system for the OpenStack + Chef project on Launchpad. You can [https://blueprints.launchpad.net/openstack-chef/+addspec create a new blueprint] that may be targeted to a milestone and tracked appropriately.
 
For major feature enhancements and planning you can use Launchpad's Blueprints system for the OpenStack + Chef project on Launchpad. You can [https://blueprints.launchpad.net/openstack-chef/+addspec 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
+
The process for blueprint content reviews is documented here: https://opendev.org/openstack/openstack-chef-specs
 
 
==Code==
 
 
 
The canonical upstream Chef cookbooks and example repository are located in the [https://github.com/stackforge Stackforge Github organization]. There is a single Chef cookbook for each integrated OpenStack project:
 
 
 
* [https://github.com/stackforge/cookbook-openstack-bare-metal OpenStack Bare Metal (Ironic) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-block-storage OpenStack Block Storage (Cinder) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-compute OpenStack Compute (Nova) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-dashboard OpenStack Dashboard (Horizon) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-data-processing OpenStack Data Processing (Sahara) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-database OpenStack Database (Trove) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-identity OpenStack Identity (Keystone) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-image OpenStack Image (Glance) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-network OpenStack Network (formerly known as Quantum) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-object-storage OpenStack Object Storage (Swift) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-orchestration OpenStack Orchestration (Heat) cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-telemetry OpenStack Telemetry (formerly known as Metering) (Ceilometer) cookbook]
 
 
 
In addition to the project cookbooks, there are five support cookbooks:
 
 
 
* [https://github.com/stackforge/cookbook-openstack-client Client provider cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-common Common library cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-ops-database Example database configuration cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-ops-messaging Example message queue configuration cookbook]
 
* [https://github.com/stackforge/cookbook-openstack-integration-test OpenStack Integration Test Suite (Tempest) cookbook]
 
* [https://github.com/ceph/ceph-cookbook A distributed network storage and filesystem (Ceph) cookbook]
 
 
 
As well as an example [http://docs.opscode.com/essentials_repository.html Chef Repository] that sets up an OpenStack environment:
 
 
 
* [https://github.com/stackforge/openstack-chef-repo Example OpenStack Chef Repository]
 
 
 
==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.
 
 
 
{| class="wikitable"
 
|-
 
! Branch !! Status !! Platforms
 
|-
 
| Grizzly || stable - frozen || Ubuntu 12.04
 
|-
 
| Havana || stable - frozen || Ubuntu 12.04, RedHat 6.5, Suse 11.03
 
|-
 
| Icehouse || stable - frozen|| Ubuntu 12.04, RedHat 6.5, Suse 11.03
 
|-
 
| Juno || stable - fixes || Ubuntu 14.04, RedHat 7
 
|-
 
| Kilo - Master || development || Ubuntu 14.04, RedHat 7, Suse 11.03
 
|-
 
| Liberty || coming 3Q2015 ||
 
 
 
|}
 
 
 
Release branching work items [https://wiki.openstack.org/wiki/OpenstackChefStablebranchCreateNotes page]
 
  
 
==How to Contribute==
 
==How to Contribute==
 
We have broken this off into another page [https://wiki.openstack.org/wiki/Chef/Contributing here].
 
We have broken this off into another page [https://wiki.openstack.org/wiki/Chef/Contributing here].

Latest revision as of 11:12, 2 September 2019

This page serves as a getting started guide for community members interested in introducing themselves to the OpenStack Chef cookbooks and community.

Communication

  • The OpenStack + Chef community leverages the main openstack-discuss mailing list with the tag of [chef] in the subject line.
  • There is an #openstack-chef channel on freenode.net. Come hang out with us and collaborate there.
  • We have a maintainers list located here. Please don't hesitate to reach out.

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://opendev.org/openstack/openstack-chef-specs

How to Contribute

We have broken this off into another page here.