mqtt - Опубликовать сообщение в MQTT-теме для IoT

Описание
Требования (для хоста, на котором выполняется модуль)
Параметры
Примеры
Примечания
- Состояние

Описание

Опубликовать сообщение в MQTT-теме.

Требования (для хоста, на котором выполняется модуль)

mosquitto

Параметры

параметр	обязательно	значение по умолчанию	допустимые значения	комментарии
ca_certs (добавлено в 2.3)	нет	None		Путь к файлам сертификатов Центра сертификации, которые должны считаться доверенными этим клиентом. Если это единственный указанный параметр, клиент будет работать аналогично веб-браузеру. То есть, он будет требовать от брокера сертификат, подписанный Центрами сертификации в ca_certs, и будет использовать TLS v1 для связи, но не будет пытаться выполнить какой-либо тип аутентификации. Это обеспечивает базовую шифрование сети, но может быть недостаточно в зависимости от настроек брокера.
certfile (добавлено в 2.3)	нет	None		Путь к клиенту PEM-кодированному сертификату. Если не None, он будет использоваться в качестве информации о клиенте для аутентификации TLS. Поддержка этой функции зависит от брокера.
client_id	нет	hostname + pid		Идентификатор MQTT-клиента
keyfile (добавлено в 2.3)	нет	None		Путь к PEM-кодированному закрытому ключу клиента. Если не None, он будет использоваться в качестве информации о клиенте для аутентификации TLS. Поддержка этой функции зависит от брокера.
password	нет			Пароль для `username` аутентификации с брокером.
payload	да			Загрузка. Специальная строка `"None"` может использоваться для отправки NULL (т.е. пустой) загрузки, что полезно для простого уведомления с помощью темы или для очистки ранее сохранённых сообщений.
port	нет	1883		Номер порта MQTT-брокера
qos	нет		0 1 2	QoS (Качество обслуживания)
retain	нет			Установка этого флага заставляет брокер сохранять (т.е. хранить) сообщение, чтобы приложения, которые впоследствии подпишутся на тему, могли получить последнее сохранённое сообщение сразу.
server	нет	localhost		Адрес/имя MQTT-брокера
topic	да			Имя MQTT-темы
username	нет			Имя пользователя для аутентификации с брокером.

Примеры

- mqtt:
    topic: 'service/ansible/{{ ansible_hostname }}'
    payload: 'Hello at {{ ansible_date_time.iso8601 }}'
    qos: 0
    retain: False
    client_id: ans001
  delegate_to: localhost

Примечания

Примечание

Этот модуль требует подключения к MQTT-брокеру, например, Mosquitto http://mosquitto.org, и Paho mqtt Python-клиенту (https://pypi.python.org/pypi/paho-mqtt).

Состояние

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.

Для получения помощи в разработке модулей, если вы заинтересованы, ознакомьтесь с информацией и сотрудничеством сообщества, тестированием Ansible и разработкой модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/mqtt_module.html