deric4 / rabbitmq-autocluster

Automatically manage node membership in RabbitMQ clusters

RabbitMQ Autocluster

A RabbitMQ plugin that clusters nodes automatically using Consul, etcd2, DNS, AWS EC2 tags or AWS Autoscaling Groups for service discovery.

Note: This plugin is not a replacement for first-hand knowledge of how to manually create a RabbitMQ cluster. If you run into issues using the plugin, you should try and manually create the cluster in the same environment as you are trying to use the plugin in. For information on how to cluster RabbitMQ manually, please see the RabbitMQ documentation.

Download

Downloads of autocluster can be found on the GitHub Releases page.

Check for version compatibility in the release notes.

Important The rabbitmq_autocluster plugin requires Erlang R17.5 or higher. This may not correspond with the minimum Erlang version required by RabbitMQ.

Installation

1. Place both autocluster-%%VSN%%.ez and the rabbitmq_aws-%%VSN%%.ez plugin files in the RabbitMQ plugins directory.
2. Run rabbitmq-plugins enable autocluster.
3. Configure the plugin.

Alternatively, there is a pre-built Docker Image available at on DockerHub as aweber/rabbitmq-autocluster.

Note As of version 0.5 the autocluster plugin does not have a default backend configured. See the Project Wiki for configuration details.

Configuration

Configuration documentation can be found in the Project Wiki.

Development

Instructions for setting up the development environment can be found in the Project Wiki.

License

BSD 3-Clause