Skip to content

jkeilson/ansible-role-rabbitmq

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

85 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.7.7'

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:
  - rabbit:
    - tcp_listeners:
      - "'0.0.0.0'": 5671

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.

Erlang Cookie

Set the rabbitmq_erlang_cookie variable to define the Erlang cookie.

rabbitmq_erlang_cookie: g9avtqdzdm2p5oe9

License

MIT

About

RabbitMQ Ansible Role

Resources

License

Stars

Watchers

Forks

Packages

No packages published