Ansible Role: RabbitMQ

This role installs RabbitMQ on Linux systems.

Requirements

For Red Hat / CentOS, you need the EPEL repository. You can install it using the geerlingguy.repo-epel role.

Role Variables

Here are the available variables along with their default values (found in defaults/main.yml):

rabbitmq_daemon: rabbitmq-server
rabbitmq_state: started
rabbitmq_enabled: true

These variables control the state of the RabbitMQ daemon and if it starts when the system boots.

rabbitmq_version: "3.9.13"

This specifies the version of RabbitMQ to install.

rabbitmq_rpm: "rabbitmq-server-{{ rabbitmq_version }}-1.el{{ ansible_distribution_major_version }}.noarch.rpm"
rabbitmq_rpm_url: "https://packagecloud.io/rabbitmq/rabbitmq-server/packages/el/{{ ansible_distribution_major_version }}/{{ rabbitmq_rpm }}/download"

For RedHat/CentOS, these variables manage the .rpm file to install.

rabbitmq_apt_repository: "deb [signed-by=/etc/apt/trusted.gpg.d/rabbitmq-9F4587F226208342.gpg] https://ppa1.novemberain.com/rabbitmq/rabbitmq-server/deb/{{ ansible_distribution | lower }} {{ ansible_distribution_release }} main"
rabbitmq_apt_gpg_url: "https://ppa.novemberain.com/gpg.9F4587F226208342.key"

erlang_apt_repository: "deb [signed-by=/etc/apt/trusted.gpg.d/erlang-E495BB49CC4BBE5B.gpg] https://ppa2.novemberain.com/rabbitmq/rabbitmq-erlang/deb/{{ ansible_distribution | lower }} {{ ansible_distribution_release }} main"
erlang_apt_gpg_url: "https://ppa.novemberain.com/gpg.E495BB49CC4BBE5B.key"

For Debian/Ubuntu, these variables set up the repository for installation.

Dependencies

There are no dependencies.

Example Playbook

Here’s an example of how to use this role in a playbook:

- hosts: rabbitmq
  roles:
    - name: geerlingguy.repo-epel
      when: ansible_os_family == 'RedHat'
    - geerlingguy.rabbitmq

License

This role is licensed under MIT / BSD.

Author Information

This role was created in 2017 by Jeff Geerling, who is also the author of Ansible for DevOps.