Chef/Contributing/NewCookbook

<under construction>

How to create a new Stackforge OpenStack cookbook

Describe the basic steps to create a new cookbook for an openstack project.

Blueprint

• create a spec/blueprint to cover the basic scope of this cookbook https://github.com/stackforge/openstack-chef-specs
  • include general view of recipe functions, any platform issues (we support ubuntu, redhat, suse), basic use cases to be covered
  • Attend meetings and chat on ML to get spec approved and assigned to a release
  • Example: https://review.openstack.org/#/c/140983/

Stackforge Project

• create a stackforge project https://github.com/stackforge
• assign the "chef-manager-core" gerrit group to the project
• create a patch with the basic cookbook files for getting thru first gate example: https://review.openstack.org/#/c/145120/
  • .gitignore
  • .gitreview
  • .rubocop.yml
  • Berksfile
  • CONTRIBUTING.md
  • Gemfile
  • metadata.md
  • Rakefile
  • README.md
  • TESTING.md
  • /spec/spec_helper.rb

Infra Integration

• create a infra patch https://github.com/openstack-infra/project-config
  • https://review.openstack.org/#/c/143800/

back to contributing page: https://wiki.openstack.org/w/index.php?title=Chef/Contributing