tower_notification – создание, обновление или удаление уведомлений Ansible Tower
Новое в версии 2.8.
Обзор
- Создание, обновление или удаление уведомлений Ansible Tower. См. https://www.ansible.com/tower для обзора.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- ansible-tower-cli >= 3.0.2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account_sid - | SID учетной записи Twillio. Требуется, если notification_type=twillio. | |
| account_token - | Токен учетной записи Twillio. Требуется, если notification_type=twillio. | |
| api_url - | URL API HipChat. Требуется, если notification_type=hipchat. | |
| channels список | Назначенные каналы Slack. Требуется, если notification_type=slack. | |
| client_name - | Идентификатор клиента PagerDuty. Требуется, если notification_type=pagerduty. | |
| color - |
| Цвет уведомления. Требуется, если notification_type=hipchat. |
| description - | Описание уведомления. | |
| from_number - | Исходный номер телефона. Требуется, если notification_type=twillio. | |
| headers - | HTTP-заголовки в виде JSON-строки. Требуется, если notification_type=webhook. | |
| host - | Хост сервера электронной почты. Требуется, если notification_type=email. | |
| message_from - | Метка, отображаемая с уведомлением. Требуется, если notification_type=hipchat. | |
| name - / обязательно | Имя уведомления. | |
| nickname - | Псевдоним IRC. Требуется, если notification_type=irc. | |
| notification_configuration - | Файл конфигурации уведомлений. Обратите внимание, указание этого поля отключит все поля, связанные с настройкой уведомлений. | |
| notification_type - / обязательно |
| Тип уведомления, которое будет отправлено. |
| notify булево |
| Триггер канала уведомления. Требуется, если notification_type=hipchat. |
| organization - | Организация, к которой относится уведомление. | |
| password - | Пароль сервера электронной почты. Требуется, если notification_type=email или если notification_type=irc. | |
| port - | Порт сервера электронной почты. Требуется, если notification_type=email или если notification_type=irc. | |
| recipients - | Электронные адреса получателей. Требуется, если notification_type=email. | |
| rooms список | Комнаты HipChat для отправки уведомления. Требуется, если notification_type=hipchat. | |
| sender - | Адрес отправителя электронной почты. Требуется, если notification_type=email. | |
| server - | Адрес сервера IRC. Требуется, если notification_type=irc. | |
| service_key - | Ключ API службы/интеграции PagerDuty. Требуется, если notification_type=pagerduty. | |
| state - |
| Желаемое состояние ресурса. |
| subdomain - | Поддомен PagerDuty. Требуется, если notification_type=pagerduty. | |
| targets список | Назначенные каналы или пользователи. Требуется, если notification_type=irc. | |
| to_numbers - | Назначенные номера телефонов. Требуется, если notification_type=twillio. | |
| token - | Токен доступа. Требуется, если notification_type=slack, если notification_type=pagerduty или если notification_type=hipchat. | |
| tower_config_file путь | Путь к файлу конфигурации Tower. | |
| tower_host строка | URL вашей инстанции Tower. | |
| tower_password строка | Пароль для вашей инстанции Tower. | |
| tower_username строка | Имя пользователя для вашей инстанции Tower. | |
| url - | Целевой URL. Требуется, если notification_type=webhook. | |
| use_ssl булево |
| Триггер SSL. Требуется, если notification_type=email или если notification_type=irc. |
| use_tls булево |
| Триггер TLS. Требуется, если notification_type=email. |
| username - | Имя пользователя сервера электронной почты. Требуется, если notification_type=email. | |
| validate_certs булево |
| Разрешить ли небезопасные подключения к Tower. Если no, сертификаты SSL не будут проверены.Это следует использовать только на сайтах, контролируемых лично, используя самоподписанные сертификаты. псевдонимы: tower_verify_ssl |
Примечания
Примечание
- Если config_file не указан, мы попытаемся использовать значения по умолчанию библиотеки tower-cli, чтобы найти информацию о хосте Tower.
- config_file должен содержать конфигурацию Tower в следующем формате host=hostname username=username password=password
Примеры
- name: Add Slack notification
tower_notification:
name: slack notification
notification_type: slack
channels:
- general
token: cefda9e2be1f21d11cdd9452f5b7f97fda977f42
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Add webhook notification
tower_notification:
name: webhook notification
notification_type: webhook
url: http://www.example.com/hook
headers:
X-Custom-Header: value123
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Add email notification
tower_notification:
name: email notification
notification_type: email
username: user
password: s3cr3t
sender: tower@example.com
recipients:
- user1@example.com
host: smtp.example.com
port: 25
use_tls: no
use_ssl: no
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Add twilio notification
tower_notification:
name: twilio notification
notification_type: twilio
account_token: a_token
account_sid: a_sid
from_number: '+15551112222'
to_numbers:
- '+15553334444'
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Add PagerDuty notification
tower_notification:
name: pagerduty notification
notification_type: pagerduty
token: a_token
subdomain: sub
client_name: client
service_key: a_key
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Add HipChat notification
tower_notification:
name: hipchat notification
notification_type: hipchat
token: a_token
message_from: user1
api_url: https://hipchat.example.com
color: red
rooms:
- room-A
notify: yes
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Add IRC notification
tower_notification:
name: irc notification
notification_type: irc
nickname: tower
password: s3cr3t
targets:
- user1
port: 8080
server: irc.example.com
use_ssl: no
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Delete notification
tower_notification:
name: old notification
notification_type: email
state: absent
tower_config_file: "~/tower_cli.cfg"
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [preview]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Samuel Carpentier (@samcarpentier)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/tower_notification_module.html