RETIRED, Chef Cookbook - Support Cookbook for Messaging
Go to file
John Dewey 3b35ac204d Configure rabbit and EPMD to bind to an address
This change integrates against a rabbitmq cookbook feature which
is not yet merged upstream.  However, given the default code path
does not change, felt okay to get this out there.  Especially b/c
we are dependant on it.  This feature allows one to run rabbit
and clustering across a specific address.  For more details, see:
  http://tickets.opscode.com/browse/COOK-3320

Change-Id: I2a10c551cb2176dadaee8842eeadfdfc8cb93e44
2013-07-14 21:01:11 -07:00
attributes Configure rabbit and EPMD to bind to an address 2013-07-14 21:01:11 -07:00
recipes Configure rabbit and EPMD to bind to an address 2013-07-14 21:01:11 -07:00
spec Configure rabbit and EPMD to bind to an address 2013-07-14 21:01:11 -07:00
.gitignore Updating with patterns used in ops-database 2013-06-27 17:00:06 -07:00
.gitreview Initial commit of openstack-ops-messaging cookbook 2013-06-18 19:36:08 -04:00
.tailor Updating with patterns used in ops-database 2013-06-27 17:00:06 -07:00
Berksfile Initial commit of openstack-ops-messaging cookbook 2013-06-18 19:36:08 -04:00
Berksfile.lock Removed attributes now handled by `openstack-common` 2013-07-03 11:04:31 -07:00
CHANGELOG.md Initial commit of openstack-ops-messaging cookbook 2013-06-18 19:36:08 -04:00
Gemfile Initial commit of openstack-ops-messaging cookbook 2013-06-18 19:36:08 -04:00
Gemfile.lock Updating with patterns used in ops-database 2013-06-27 17:00:06 -07:00
LICENSE first commit 2013-05-06 16:45:32 -05:00
README.md Configure rabbit and EPMD to bind to an address 2013-07-14 21:01:11 -07:00
Strainerfile Initial commit of openstack-ops-messaging cookbook 2013-06-18 19:36:08 -04:00
metadata.rb Updating with patterns used in ops-database 2013-06-27 17:00:06 -07:00

README.md

Description

This cookbook provides shared message queue configuration for the OpenStack Grizzly reference deployment provided by Chef for OpenStack. The http://github.com/mattray/chef-openstack-repo contains documentation for using this cookbook in the context of a full OpenStack deployment. It currently supports RabbitMQ and will soon other queues.

Requirements

Chef 11 with Ruby 1.9.x required.

Platforms

  • Ubuntu-12.04

Cookbooks

The following cookbooks are dependencies:

  • openstack-common
  • rabbitmq

Usage

The usage of this cookbook is optional, you may choose to set up your own messaging service without using this cookbook. If you choose to do so, you will need to provide all of the attributes listed under the Attributes.

Resources/Providers

None

Templates

None

Recipes

server

  • message queue server configuration, selected by attributes

rabbitmq-server

  • configures the RabbitMQ server for OpenStack

Attributes

  • openstack["mq"]["bind_interface"] - bind to interfaces IPv4 address
  • openstack["mq"]["erl_bind_networking"] - whether or not to bind rabbit and epmd to the listen address determined by openstack["mq"]["bind_interface"]
  • openstack["mq"]["cluster"] - whether or not to cluster rabbit, defaults to 'false'

Testing

This cookbook uses bundler, berkshelf, and strainer to isolate dependencies and run tests.

Tests are defined in Strainerfile.

To run tests:

$ bundle install # install gem dependencies
$ bundle exec berks install # install cookbook dependencies
$ bundle exec strainer test # run tests

License and Author

Author John Dewey (john@dewey.ws)
Author Matt Ray (matt@opscode.com)
Author Craig Tracey (craigtracey@gmail.com)
Copyright Copyright (c) 2013, Opscode, Inc.
Copyright Copyright (c) 2013, Craig Tracey
Copyright Copyright (c) 2013, AT&T Services, 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.