Juju Charm - RabbitMQ
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
OpenDev Sysadmins 63388ae0a5 OpenDev Migration Patch 1 month ago
actions Added list-unconsumed-queues action 2 months ago
charmhelpers Sync charm-helpers to enable Ubuntu Disco 1 month ago
hooks Merge "Added list-unconsumed-queues action" 2 months ago
lib Update tox.ini files from release-tools gold copy 2 years ago
scripts Do not accidentaly overwrite DATA_FILE 5 months ago
templates Change charm to py3 7 months ago
tests Enable bionic/stein and disco/stein functional tests 1 month ago
unit_tests Merge "Added list-unconsumed-queues action" 2 months ago
.gitignore Fix incorrect syntax in scripts/check_rabbitmq.py 6 months ago
.gitreview OpenDev Migration Patch 1 month ago
.stestr.conf Fix lint in unit tests re: py3-first and py2 compat 6 months ago
.zuul.yaml Added tox environment for gathering coverage 2 months ago
LICENSE Re-license charm as Apache-2.0 2 years ago
Makefile Change charm to py3 7 months ago
README.md Trivial grammar changes: 8 months ago
actions.yaml Added list-unconsumed-queues action 2 months ago
charm-helpers-hooks.yaml Update charm-helpers-hooks.yaml and sync ch 3 months ago
config.yaml Clarify how to use queue_thresholds 1 month ago
copyright Re-license charm as Apache-2.0 2 years ago
hardening.yaml Add hardening support 3 years ago
icon.svg Added icon.svg 6 years ago
metadata.yaml Update series metadata 1 month ago
requirements.txt Update requirements 7 months ago
revision Added stats cronjob and queue monitoring nagios plugin 5 years ago
setup.cfg Add project infomation into setup.cfg 4 months ago
test-requirements.txt Replace ostestr with stestr in testing framework. 2 months ago
tox.ini Replace ostestr with stestr in testing framework. 2 months ago



RabbitMQ is an implementation of AMQP, the emerging standard for high performance enterprise messaging.

The RabbitMQ server is a robust and scalable implementation of an AMQP broker.

This charm deploys RabbitMQ server and provides AMQP connectivity to clients.


To deploy this charm:

juju deploy rabbitmq-server

deploying multiple units will form a native RabbitMQ cluster:

juju deploy -n 3 rabbitmq-server
juju config rabbitmq-server min-cluster-size=3

To make use of AMQP services, simply relate other charms that support the rabbitmq interface:

juju add-relation rabbitmq-server nova-cloud-controller


When more than one unit of the charm is deployed the charm will bring up a native RabbitMQ cluster. The process of clustering the units together takes some time. Due to the nature of asynchronous hook execution, it is possible client relationship hooks are executed before the cluster is complete. In some cases, this can lead to client charm errors.

To guarantee client relation hooks will not be executed until clustering is completed use the min-cluster-size configuration setting:

juju deploy -n 3 rabbitmq-server
juju config rabbitmq-server min-cluster-size=3

When min-cluster-size is not set the charm will still cluster, however, there are no guarantees client relation hooks will not execute before it is complete.

Single unit deployments behave as expected.

Configuration: SSL

Generate an unencrypted RSA private key for the servers and a certificate:

openssl genrsa -out rabbit-server-privkey.pem 2048

Get an X.509 certificate. This can be self-signed, for example:

openssl req -batch -new -x509 -key rabbit-server-privkey.pem -out rabbit-server-cert.pem -days 10000

Deploy the service:

juju deploy rabbitmq-server

Enable SSL, passing in the key and certificate as configuration settings:

juju set rabbitmq-server ssl_enabled=True ssl_key="`cat rabbit-server-privkey.pem`" ssl_cert="`cat rabbit-server-cert.pem`"

Configuration: source

To change the source that the charm uses for packages:

juju set rabbitmq-server source="cloud:precise-icehouse"

This will enable the Icehouse pocket of the Cloud Archive (which contains a new version of RabbitMQ) and upgrade the install to the new version.

The source option can be used in a few different ways:

source="ppa:james-page/testing" - use the testing PPA owned by james-page
source="http://myrepo/ubuntu main" - use the repository located at the provided URL

The charm also supports use of arbitrary archive key’s for use with private repositories:

juju set rabbitmq-server key="C6CEA0C9"

Note that in clustered configurations, the upgrade can be a bit racey as the services restart and re-cluster; this is resolvable using (with Juju version < 2.0) :

juju resolved --retry rabbitmq-server/1

Or using the following command with Juju 2.0 and above:

juju resolved rabbitmq-server/1

Network Spaces support

This charm supports the use of Juju Network Spaces, allowing the charm to be bound to network space configurations managed directly by Juju. This is only supported with Juju 2.0 and above.

The amqp relation can be bound to a specific network space, allowing client connections to be routed over specific networks:

juju deploy rabbitmq-server --bind "amqp=internal-space"

alternatively this can also be provided as part of a juju native bundle configuration:

  charm: cs:xenial/rabbitmq-server
  num_units: 1
    amqp: internal-space

NOTE: Spaces must be configured in the underlying provider prior to attempting to use them.

NOTE: Existing deployments using the access-network configuration option will continue to function; this option is preferred over any network space binding provided if set.

Contact Information

Author: OpenStack Charmers openstack-charmers@lists.ubuntu.com Bugs: http://bugs.launchpad.net/charms/+source/rabbitmq-server/+filebug Location: http://jujucharms.com/rabbitmq-server