rabbitmq_queue – This module manages rabbitMQ queues
rabbitmq_queue – This module manages rabbitMQ queues
New in version 2.0.
Synopsis
- This module uses rabbitMQ Rest API to create/delete queues
Requirements
The below requirements are needed on the host that executes this module.
- requests >= 1.0.0
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
arguments - |
Default: {} |
extra arguments for queue. If defined this argument is a key/value dictionary |
auto_delete boolean |
|
if the queue should delete itself after all queues/queues unbound from it |
auto_expires - |
Default: "forever" |
How long a queue can be unused before it is automatically deleted (milliseconds) |
dead_letter_exchange - |
Optional name of an exchange to which messages will be republished if they are rejected or expire | |
dead_letter_routing_key - |
Optional replacement routing key to use when a message is dead-lettered. Original routing key will be used if unset | |
durable boolean |
|
whether queue is durable or not |
login_host - |
Default: "localhost" |
rabbitMQ host for connection |
login_password boolean |
|
rabbitMQ password for connection |
login_port - |
Default: 15672 |
rabbitMQ management api port |
login_user - |
Default: "guest" |
rabbitMQ user for connection |
max_length - |
Default: "no limit" |
How many messages can the queue contain before it starts rejecting |
max_priority - added in 2.4 |
Maximum number of priority levels for the queue to support. If not set, the queue will not support message priorities. Larger numbers indicate higher priority. | |
message_ttl - |
Default: "forever" |
How long a message can live in queue before it is discarded (milliseconds) |
name - / required |
Name of the queue to create | |
state - |
|
Whether the queue should be present or absent |
vhost - |
Default: "/" |
rabbitMQ virtual host |
Examples
# Create a queue
- rabbitmq_queue:
name: myQueue
# Create a queue on remote host
- rabbitmq_queue:
name: myRemoteQueue
login_user: user
login_password: secret
login_host: remote.example.org
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Manuel Sousa (@manuel-sousa)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/rabbitmq_queue_module.html