community.rabbitmq.rabbitmq lookup – Retrieve messages from an AMQP/AMQPS RabbitMQ queue.
Note
This lookup plugin is part of the community.rabbitmq collection (version 1.3.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.rabbitmq
.
You need further requirements to be able to use this lookup plugin,
see Requirements for details.
To use it in a playbook, specify: community.rabbitmq.rabbitmq
.
Synopsis
This lookup uses a basic get to retrieve all, or a limited number
count
, messages from a RabbitMQ queue.
Requirements
The below requirements are needed on the local controller node that executes this lookup.
The python pika package https://pypi.org/project/pika/.
Keyword parameters
This describes keyword parameters of the lookup. These are the values key1=value1
, key2=value2
and so on in the following
examples: lookup('community.rabbitmq.rabbitmq', key1=value1, key2=value2, ...)
and query('community.rabbitmq.rabbitmq', key1=value1, key2=value2, ...)
Parameter |
Comments |
---|---|
How many messages to collect from the queue. If not set, defaults to retrieving all the messages from the queue. |
|
The queue to get messages from. |
|
An URI connection string to connect to the AMQP/AMQPS RabbitMQ server. For more information refer to the URI spec https://www.rabbitmq.com/uri-spec.html. |
Notes
Note
This lookup implements BlockingChannel.basic_get to get messages from a RabbitMQ server.
After retrieving a message from the server, receipt of the message is acknowledged and the message on the server is deleted.
Pika is a pure-Python implementation of the AMQP 0-9-1 protocol that tries to stay fairly independent of the underlying network support library.
More information about pika can be found at https://pika.readthedocs.io/en/stable/.
This plugin is tested against RabbitMQ. Other AMQP 0.9.1 protocol based servers may work but not tested/guaranteed.
Assigning the return messages to a variable under
vars
may result in unexpected results as the lookup is evaluated every time the variable is referenced.Currently this plugin only handles text based messages from a queue. Unexpected results may occur when retrieving binary data.
Examples
- name: Get all messages off a queue
debug:
msg: "{{ lookup('community.rabbitmq.rabbitmq', url='amqp://guest:[email protected]:5672/%2F', queue='hello') }}"
# If you are intending on using the returned messages as a variable in more than
# one task (eg. debug, template), it is recommended to set_fact.
- name: Get 2 messages off a queue and set a fact for re-use
set_fact:
messages: "{{ lookup('community.rabbitmq.rabbiotmq', url='amqp://guest:[email protected]:5672/%2F', queue='hello', count=2) }}"
- name: Dump out contents of the messages
debug:
var: messages
Return Value
Key |
Description |
---|---|
A list of dictionaries with keys and value from the queue. Returned: success |
|
The content_type on the message in the queue. Returned: success |
|
The delivery_mode on the message in the queue. Returned: success |
|
The delivery_tag on the message in the queue. Returned: success |
|
The exchange the message came from. Returned: success |
|
The headers for the message returned from the queue. Returned: success |
|
If application/json is specified in content_type, json will be loaded into variables. Returned: success |
|
The message_count for the message on the queue. Returned: success |
|
The content of the message. Returned: success |
|
The redelivered flag. True if the message has been delivered before. Returned: success |
|
The routing_key on the message in the queue. Returned: success |