rocketchat – Отправка уведомлений в Rocket Chat
Новая версия 2.2.
Описание
- Модуль
rocketchatотправляет уведомления в Rocket Chat через интеграцию Incoming WebHook.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| attachments - | Определяет список вложений. | |
| channel - | Канал для отправки сообщения. Если параметр отсутствует, сообщение отправляется в канал, выбранный для токен, указанного во время создания веб-хука. | |
| color - |
| Разрешает использовать стандартные цвета текста. Использование значения 'normal' по умолчанию предотвращает отправку пользовательской цветовой полосы в начале сообщения. |
| domain - / обязательно | Домен вашей среды без протокола. (например, example.com или chat.example.com) | |
| icon_emoji - | Эмодзи отправителя сообщения. Представление доступных эмодзи можно получить в Rocket Chat. (например :thumbsup:) (если установлен параметр icon_emoji, параметр icon_url не будет использоваться) | |
| icon_url - | По умолчанию: "https://www.ansible.com/favicon.ico" | URL иконки отправителя сообщения. |
| link_names - |
| Автоматически создает ссылки на каналы и имена пользователей в msg. |
| msg - | Сообщение для отправки. | |
| protocol - |
| Указывает протокол, используемый для отправки сообщений уведомлений перед URL веб-хука. (т.е. http или https) |
| token - / обязательно | Токен интеграции Incoming Webhook Rocket Chat. Обеспечивает аутентификацию для отправки сообщений через веб-хук Rocket Chat. | |
| username - | По умолчанию: "Ansible" | Отправитель сообщения. |
| validate_certs boolean |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах под личным контролем, использующих самозаверенные сертификаты. |
Примеры
- name: Send notification message via Rocket Chat
rocketchat:
token: thetoken/generatedby/rocketchat
domain: chat.example.com
msg: '{{ inventory_hostname }} completed'
delegate_to: localhost
- name: Send notification message via Rocket Chat all options
rocketchat:
domain: chat.example.com
token: thetoken/generatedby/rocketchat
msg: '{{ inventory_hostname }} completed'
channel: #ansible
username: 'Ansible on {{ inventory_hostname }}'
icon_url: http://www.example.com/some-image-file.png
link_names: 0
delegate_to: localhost
- name: insert a color bar in front of the message for visibility purposes and use the default webhook icon and name configured in rocketchat
rocketchat:
token: thetoken/generatedby/rocketchat
domain: chat.example.com
msg: '{{ inventory_hostname }} is alive!'
color: good
username: ''
icon_url: ''
delegate_to: localhost
- name: Use the attachments API
rocketchat:
token: thetoken/generatedby/rocketchat
domain: chat.example.com
attachments:
- text: Display my system load on host A and B
color: #ff00dd
title: System load
fields:
- title: System A
value: 'load average: 0,74, 0,66, 0,63'
short: True
- title: System B
value: 'load average: 5,16, 4,64, 2,43'
short: True
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| changed boolean | success | Флаг, указывающий, были ли внесены какие-либо изменения. |
Статус
- Отсутствие гарантии обратной совместимости интерфейса модуля. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Ramon de la Fuente (@ramondelafuente)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/rocketchat_module.html