Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms


openstack-network (9) Versions 16.0.0

Installs and configures the OpenStack Network API Service and various agents and plugins

cookbook 'openstack-network', '= 16.0.0'
cookbook 'openstack-network', '= 16.0.0', :supermarket
knife supermarket install openstack-network
knife supermarket download openstack-network
Quality 75%

Team and repository tags

Team and repository tags

<!-- Change things from this point on -->

Chef OpenStack Logo


This cookbook installs the OpenStack Network service Neutron as part of a Chef reference deployment of OpenStack. The contains documentation for using this cookbook in the context of a full OpenStack deployment.

More information about the OpenStack Network service is available here


OpenStack Network's design is modular, with plugins available that handle L2 and L3 networking for various hardware vendors and standards.


  • Chef 12 or higher
  • chefdk 0.9.0 or higher for testing (also includes berkshelf for cookbook dependency resolution)


  • ubuntu
  • redhat
  • centos


The following cookbooks are dependencies:

  • 'openstack-common', '>= 14.0.0'
  • 'openstack-identity', '>= 14.0.0'
  • 'openstackclient', '>= 0.1.0'


Please see the extensive inline documentation in attributes/*.rb for descriptions of all the settable attributes for this cookbook.

Note that all attributes are in the default['openstack'] "namespace"

The usage of attributes to generate the neutron.conf is described in the openstack-common cookbook.



  • Install the network client packages


  • Migrates the neutron database


  • Configures common pieces needed for all neutron services and create the neutron.conf


  • Installs the DHCP agent

The configuration for neutron-dhcp-agent is generated from the attributes in using the same template as for the neutron.conf



This is a 'work in progress' recipe and is currently not tested - Installs the Firewall as a Service


  • Registers the OpenStack Network API endpoint and service user with Keystone


  • Installs the L3 agent

The configuration for neutron-l3-agent is generated from the attributes in using the same template as for the neutron.conf



  • Installs the Loadbalancer as a Service

The configuration for neutron-lbaas-agent is generated from the attributes in using the same template as for the neutron.conf



  • Installs the metadata agent

The configuration for neutron-metadata-agent is generated from the attributes in using the same template as for the neutron.conf



  • Installs the metering agent

The configuration for neutron-metadata-agent is generated from the attributes in using the same template as for the neutron.conf



  • Configure the ml2_core_plugin


  • Configure the ml2 linuxbridge plugin


  • Configure the ml2 openvswitch plugin


  • Installs openvswitch


  • Installs the openvswitch agent


  • Generates all the needed plugin configurations directly from the attributes in:

The final configuration file is generated exactly like all OpenStack service configuration files (e.g. neutron.conf), but the attribute mentioned above allows you additionally to define the file name and patch with:

# this will also generate the path recursively if not already existent
# this defines the filename for the plugin config (e.g. ml2_conf.ini)

In the examples above, the variable 'myplugin' can be used to generate multiple plugin configurations with different configs and filenames. Please refer to the recipe openstack-network::ml2_openvswitch for an full example on the usage of this attributes.


  • Installs the openstack-network API server (currently aka neutron-server)


  • Installs the VPN as a Service

The configuration for neutron-vpn-agent is generated from the attributes in using the same template as for the neutron.conf


License and Author

Authors Alan Meadows (
Jay Pipes (
Ionut Artarisi (
Salman Baset (
Jian Hua Geng (
Chen Zhiwei (
Mark Vanderwiel(
Eric Zhou(
Jan Klare (
Christoph Albers (
Copyright Copyright (c) 2013, AT&T Services, Inc.
Copyright (c) 2013-2014, SUSE Linux GmbH
Copyright (c) 2012, Rackspace US, Inc.
Copyright (c) 2013-2014, IBM Corp.
Copyright (c) 2016, cloudbau GmbH

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

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.

Collaborator Number Metric

16.0.0 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

16.0.0 passed this metric

Foodcritic Metric

16.0.0 passed this metric

No Binaries Metric

16.0.0 passed this metric

Publish Metric

16.0.0 passed this metric

Supported Platforms Metric

16.0.0 passed this metric

Testing File Metric

16.0.0 passed this metric

Version Tag Metric

16.0.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must include a tag that matches this cookbook version number