Skip to content

webarch-coop/ansible-role-rabbitmq

Repository files navigation

Webarchitects RabbitMQ Ansible Role

pipeline status

This repo contains an Ansible role to install and configure RabbitMQ on Debian, it has been written spefifically for ONLYOFFICE.

Role variables

See the defaults/main.yml file for the default variables, the vars/main.yml file for the preset variables and the meta/argument_specs.yml file for the variable specification.

rabbitmq

Set the rabbitmq variable to true run the tasks in this role, it defaults to false.

rabbitmq_configuration

A optional dictionary of variables and values to be written to /etc/rabbitmq/rabbitmq.conf, see the example conf file and the configuration documentation, the default configuration limits RabbitMQ to listen for IPv4 and IPv6 connections on the localhost:

rabbitmq_configuration:
  "listeners.tcp.local": "127.0.0.1:5672"
  "listeners.tcp.local_v6": "::1:5672"

rabbitmq_systemd_units

A dictionary to be used with the systemd role.

rabbitmq_users

A optional list of dictionary of users for the community.rabbitmq.rabbitmq_user module, currently this only support two list options, username and state. For users that are listed as present a random password will be generated and written to /root/.rabbitmq.$USER.passwd.

By default this role removes the guest role:

rabbitmq_users:
  - username: guest
    state: absent

username

The name of the RabbitMQ user.

state

The state of the RabbitMQ user, absent or present.

rabbitmq_validate

A boolean, which defaults to true, set rabbitmq_validate to false to skip using the ansible.builtin.validate_argument_spec module to validate variables that start with rabbitmq_.

Notes

Changing the hostname of a server will caused RabbitMQ to fail, see this thread.

Repository

The primary URL of this repo is https://git.coop/webarch/rabbitmq however it is also mirrored to GitHub and available via Ansible Galaxy.

If you use this role please use a tagged release, see the release notes.

Copyright

Copyright 2020-2024 Chris Croome, <[email protected]>.

This role is released under the same terms as Ansible itself, the GNU GPLv3.

About

An Ansible role to install RabbitMQ on Debian.

Resources

License

Stars

Watchers

Forks

Packages

No packages published