ansible_role_rabbitmq

RabbitMQ Ansible Role

Forked from https://github.com/jasonroyle/ansible-role-rabbitmq on 2018-08-20 to support EL 7 and RabbitMQ 3.7+.

Version

See:

Set the rabbitmq_version variable to define the version of RabbitMQ to install.

rabbitmq_version: '3.8.1'

Users

See:

Set the rabbitmq_users variable to define an array of present users.

rabbitmq_users:
  - user: admin
    password: admin
    tags: administrator
parameter required default choices comments
configure_priv no .*
password yes
read_priv no .*
tags no
user yes
vhost no /
write_priv no .*

Remove Users

Set the rabbitmq_users_absent variable to define an array of absent users.

rabbitmq_users_absent:
  - guest

Virtual Hosts

See:

Set the rabbitmq_vhosts variable to define an array of present virtual hosts.

rabbitmq_vhosts:
  - /one
  - name: /two
    node: rabbit
    tracing: no
parameter required default choices comments
name yes
node no rabbit
tracing no no
  • yes
  • no

Remove Virtual Hosts

Set the rabbitmq_vhosts_absent variable to define an array of absent virtual hosts.

rabbitmq_vhosts_absent:
  - /vhost

Plugins

See:

Set the rabbitmq_plugins variable to define an array of enabled plugins.

rabbitmq_plugins:
  - rabbitmq_management
  - name: rabbitmq_delayed_message_exchange
    url: http://www.rabbitmq.com/community-plugins/v3.6.x/rabbitmq_delayed_message_exchange-0.0.1.ez
parameter required default choices comments
name yes
url no Installs the plugin

Disable Plugins

Set the rabbitmq_plugins_disabled variable to disable plugins.

rabbitmq_plugins_disabled:
  - rabbitmq_management

Configuration

See:

Set the rabbitmq_config variable to define the configuration.

rabbitmq_config:
  listeners.tcp.default: 5672

Set the rabbitmq_env variable to define the environment variables. Note that the keys should not contain the "RABBITMQ_" prefix.

rabbitmq_env:
  DIST_PORT: 25672

Cluster

See:

Set the rabbitmq_cluster variable to enable clustering.

As the above clustering documentation is pretty hard to grasp I suggest reading of https://computingforgeeks.com/how-to-configure-rabbitmq-cluster-on-ubuntu-18-04-lts/ for quick start. And then defined minimum variable as below where the rabbitmq1 is the short hostname of the master node.

rabbitmq_cluster: yes
# shortname dns only
rabbitmq_cluster_master: "rabbit@rabbitmq1"

Please note that the default behaviour is:

  • The first node of the host group is the master
  • The ha policy is to replicate the queue for all nodes
  • Replacing non-master nodes is supported - just destroy the non-master node and re-launch.
  • Switching master node to other node is not supported unless you have to do it manually or rebuild the whole cluster.

Set the rabbitmq_erlang_cookie variable to define the Erlang cookie.

rabbitmq_erlang_cookie: g9avtqdzdm2p5oe9

License

MIT

Install
ansible-galaxy install anthemengineering/ansible-role-rabbitmq
GitHub repository
License
mit
Downloads
29700