RETIRED, Chef Cookbook - OpenStack Network
Go to file
Samuel Cassiba 3abbcabe46 Add delivery config
Change-Id: I6792466648d581a8d6cec5b0f54ae9ed51f2b503
Implements: blueprint deprecate-rakefiles
2018-04-11 22:32:37 -07:00
.delivery Add delivery config 2018-04-11 22:32:37 -07:00
attributes network refactor for Pike and Chef 13 2018-01-09 15:14:37 +00:00
recipes Update DB migration command for Queens 2018-04-05 14:09:44 +00:00
spec network refactor for Pike and Chef 13 2018-01-09 15:14:37 +00:00
templates/default Do not hardcode any DHCP options for Neutron 2016-04-08 17:04:05 +02:00
.gitignore Initial kilo updates 2015-02-27 13:52:42 -06:00
.gitreview Update .gitreview file for project rename 2015-06-12 23:12:30 +00:00
.rubocop.yml Initial network Pike updates 2017-08-25 09:57:18 -04:00
.zuul.yaml Zuul: Remove project name 2018-01-28 13:44:53 -08:00
Berksfile starting queens development patch and use git.openstack.org 2018-03-06 12:09:03 -08:00
CONTRIBUTING.md Workflow documentation is now in infra-manual 2014-12-05 03:30:44 +00:00
LICENSE network refactor for Pike and Chef 13 2018-01-09 15:14:37 +00:00
README.md add new Chef OpenStack Team Logo to README 2017-05-29 10:53:08 +02:00
Rakefile network refactor for Pike and Chef 13 2018-01-09 15:14:37 +00:00
TESTING.md Sync stackforge/cookbook* to openstack/cookbook* for neutron cookbook 2015-06-15 15:29:37 +08:00
bootstrap.sh Fix bootstrap.sh 2016-03-15 16:21:06 +01:00
metadata.rb starting queens development patch and use git.openstack.org 2018-03-06 12:09:03 -08:00

README.md

Team and repository tags

Team and repository tags

Chef OpenStack Logo

Description

This cookbook installs the OpenStack Network service Neutron as part of a Chef reference deployment of OpenStack. The https://github.com/openstack/openstack-chef-repo contains documentation for using this cookbook in the context of a full OpenStack deployment.

More information about the OpenStack Network service is available here

Usage

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

Requirements

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

Platform

  • ubuntu
  • redhat
  • centos

Cookbooks

The following cookbooks are dependencies:

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

Attributes

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.

Recipes

openstack-network::client

  • Install the network client packages

openstack-network::db_migration

  • Migrates the neutron database

openstack-network::default

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

openstack-network::dhcp_agent

  • 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

node['openstack']['network_dhcp']['conf']

openstack-network::fwaas

This is a 'work in progress' recipe and is currently not tested

  • Installs the Firewall as a Service

openstack-network::identity_registration

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

openstack-network::l3_agent

  • 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

node['openstack']['network_l3']['conf']

openstack-network::lbaas

  • 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

node['openstack']['network_lbaas']['conf']

openstack-network::metadata_agent

  • 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

node['openstack']['network_metadata']['conf']

openstack-network::metering_agent

  • 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

node['openstack']['network_metering']['conf']

openstack-network::ml2_core_plugin

  • Configure the ml2_core_plugin

openstack-network::ml2_linuxbridge

  • Configure the ml2 linuxbridge plugin

openstack-network::ml2_openvswitch

  • Configure the ml2 openvswitch plugin

openstack-network::openvswitch

  • Installs openvswitch

openstack-network::openvswitch_agent

  • Installs the openvswitch agent

openstack-network::plugin_config

  • Generates all the needed plugin configurations directly from the attributes in:
node['openstack']['network']['plugins'][myplugin]

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
node['openstack']['network']['plugins'][myplugin]['path']
# this defines the filename for the plugin config (e.g. ml2_conf.ini)
node['openstack']['network']['plugins'][myplugin]['filename']

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.

openstack-network::server

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

openstack-network::vpnaas

  • 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

node['openstack']['network_vpnaas']['conf']

License and Author

Authors Alan Meadows (alan.meadows@gmail.com)
Jay Pipes (jaypipes@gmail.com)
Ionut Artarisi (iartarisi@suse.cz)
Salman Baset (sabaset@us.ibm.com)
Jian Hua Geng (gengjh@cn.ibm.com)
Chen Zhiwei (zhiwchen@cn.ibm.com)
Mark Vanderwiel(vanderwl@us.ibm.com)
Eric Zhou(zyouzhou@cn.ibm.com)
Jan Klare (j.klare@x-ion.de)
Christoph Albers (c.albers@x-ion.de)
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

http://www.apache.org/licenses/LICENSE-2.0

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.