Spec-Zone.ru › Ansible 2.9

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
-
    Варианты:
  • yellow
  • green
  • red
  • purple
  • gray
  • random
Цвет уведомления. Требуется, если 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
- / обязательно
    Варианты:
  • email
  • slack
  • twilio
  • pagerduty
  • hipchat
  • webhook
  • irc
Тип уведомления, которое будет отправлено.
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
-
    Варианты:
  • present ←
  • absent
Желаемое состояние ресурса.
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API