This repo contains an Ansible role to install and configure RabbitMQ on Debian, it has been written spefifically for ONLYOFFICE.
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.
Set the rabbitmq
variable to true
run the tasks in this role, it defaults to false
.
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"
A dictionary to be used with the systemd role.
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
The name of the RabbitMQ user.
The state of the RabbitMQ user, absent
or present
.
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_
.
Changing the hostname of a server will caused RabbitMQ to fail, see this thread.
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 2020-2024 Chris Croome, <[email protected]>.
This role is released under the same terms as Ansible itself, the GNU GPLv3.