Skip to content

Latest commit

 

History

History
110 lines (76 loc) · 4.89 KB

README.md

File metadata and controls

110 lines (76 loc) · 4.89 KB
Raw

Description

This repository contains a collection of chef cookbooks that can be used to deploy, and manage, the suite of OpenStack core projects (nova, glance, keystone, swift, horizon).

The cookbooks have been designed and written in such a way that they can be used to deploy individual service components on any of the nodes in the infrastructure; in short they can be used for single node 'all-in-one' installs (for testing), right up to multi/many node production installs.

In order to achieve this flexibility, they make use of the chef search functionality, and therefore require that if you are deploying anything larger than a single node deployment, you use chef server to host your cookbooks rather than using chef solo.

Cookbooks

Each of the cookbooks in the cookbooks directory is actually a git submodule, linking to an individual git repository where that cookbook is maintained.

Roles

There are a number of different chef roles that are included with these cookbooks. Descriptions of each of the roles can be found in the readme in the roles directory.

Usage

getting the cookbooks
  • clone the parent repository (note the --recursive flag - this will ensure that each of the repositories that the submodules point to is also cloned):

git clone --recursive https://github.com/williamherry/openstack-cookbooks.git

  • upload your cookbooks and roles to your chef server( assuming you have already configured your knife client with the credentials of your chef server:
cd openstack-cookbooks
knife cookbook upload -o cookbooks --all
knife role from file roles/*.rb
using the cookbooks

NOTE: You must use chef >= 0.10.12

Ensure you have registered, one or more nodes with your chef server. Then use knife to assign roles to your nodes:

  • for an all-in-one deployment of nova, using keystone and glance, on a node called node1:

knife node run_list add node1 'role[allinone]'

  • for a 2 node deployment of nova, installing all nova controller functions, keystone and glance on node1, and setting node2 up as a compute server:
knife node run_list add node1 'role[single-controller]'
knife node run_list add node2 'role[single-compute]'
  • for a multi node deployment as above but with 'N' nova compute nodes
knife node run_list add node1 'role[single-controller]'
knife node run_list add node2 'role[single-compute]'
knife node run_list add node3 'role[single-compute]'
...
knife node run_list add node[n] 'role[single-compute]'
  • for a many node deployment with mysql and keystone on one node, nova core functions and horizon on another, glance on another, rabbitmq on another, and 'N' compute nodes:
knife node run_list add node1 'role[keystone]'
knife node run_list add node1 'role[mysql-master]'
knife node run_list add node2 'role[nova-controller]'
knife node run_list add node2 'role[horizon-server]'
knife node run_list add node3 'role[glance-api]'
knife node run_list add node3 'role[glance-registry]'
knife node run_list add node4 'role[rabbitmq-server]'
knife node run_list add node5 'role[single-compute]'
knife node run_list add node6 'role[single-compute]'
...
knife node run_list add nodeN 'role[single-compute]'

Custom template banners

You can define a customer string to be included in every template file managed by the Rackspace cookbooks by defining the custom_template_banner environment variable. For Example:

knife environment edit <environment name>
"override_attributes": { "custom_template_banner": "# This\n# is\n# a\n# multiline\n# message"

License and Author

Author:: Justin Shepherd (<[email protected]>)
Author:: Jason Cannavale (<[email protected]>)
Author:: Ron Pedde (<[email protected]>)
Author:: Joseph Breu (<[email protected]>)
Author:: William Kelly (<[email protected]>)
Author:: Darren Birkett (<[email protected]>)
Author:: Evan Callicoat (<[email protected]>)

Copyright 2012, Rackspace US, Inc.

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.