slack — Отправка уведомлений в Slack

Новая версия с 1.6.

Обзор
Параметры
Примеры
Статус
- Автор

Обзор

Модуль slack отправляет уведомления на http://slack.com через интеграцию Incoming WebHook.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
attachments	Значение по умолчанию: None	Определяет список вложений. Этот список соответствует JSON API Slack. Для получения дополнительной информации, см. также (https://api.slack.com/docs/attachments).
channel	Значение по умолчанию: None	Канал для отправки сообщения. Если отсутствует, сообщение отправляется в канал, выбранный для параметра token.
color (добавлено в 2.0)	Варианты: normal ← good warning danger	Разрешает использовать стандартные цвета текста — используйте значение по умолчанию 'normal', чтобы не отправлять пользовательскую цветную полосу в начале сообщения
domain	Значение по умолчанию: None	Домен Slack (поддомен) вашей среды без протокола. (например, `example.slack.com`) В версиях 1.8 и выше этот параметр устарел и может быть проигнорирован. См. документацию по параметру token для получения информации.
icon_emoji	Значение по умолчанию: None	Эмодзи отправителя сообщения. См. документацию Slack для вариантов. (Если установлен icon_emoji, то icon_url не будет использоваться)
icon_url		URL иконки отправителя сообщения (значение по умолчанию `https://www.ansible.com/favicon.ico`)
link_names	Варианты: 1 0	Автоматически создаёт ссылки для каналов и имён пользователей в параметре msg.
msg	Значение по умолчанию: None	Сообщение для отправки. Обратите внимание, что модуль не обрабатывает экранирование символов. Символы «меньше чем» и «больше чем» и амперсанды в простом тексте должны быть преобразованы в HTML-сущности (например, & в &) перед отправкой. Дополнительная информация в документации Slack (https://api.slack.com/docs/message-formatting).
parse	Варианты: full none Значение по умолчанию: None	Настройка парсера сообщений в Slack
token обязательно		Токен интеграции Slack. Он аутентифицирует вас в службе Slack. До версии 1.8 токен выглядел как `3Ffe373sfhRE6y42Fg3rvf4GlK`. В версиях 1.8 и выше Ansible адаптируется к новому API Slack, где токены выглядят как `G922VJP24/D921DW937/3Ffe373sfhRE6y42Fg3rvf4GlK`. Если токен в новом формате, то Slack проигнорирует любое значение параметра domain. Если токен в старом формате, то параметр domain обязателен. Ansible не контролирует, когда Slack откажется от старого API. Когда Slack это сделает, старый формат перестанет работать. Пожалуйста, имейте в виду, что токены не являются API-токенами, а токенами webhook. В Slack они находятся в URL webhook, которые получаются в приложениях и интеграциях. Входящие webhook можно добавить в этой области. В некоторых случаях это может быть заблокировано вашим администратором Slack, и вам необходимо запросить доступ. Именно там можно добавить входящие webhook. Ключ находится в конце URL, предоставленного вам в этой секции.
username	Значение по умолчанию: Ansible	Это отправитель сообщения.
validate_certs	Варианты: да ← нет	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, которыми вы лично контролируете, использующих самозаверяющие сертификаты.

Примеры

- name: Send notification message via Slack
  slack:
    token: thetoken/generatedby/slack
    msg: '{{ inventory_hostname }} completed'
  delegate_to: localhost

- name: Send notification message via Slack all options
  slack:
    token: thetoken/generatedby/slack
    msg: '{{ inventory_hostname }} completed'
    channel: #ansible
    username: 'Ansible on {{ inventory_hostname }}'
    icon_url: http://www.example.com/some-image-file.png
    link_names: 0
    parse: 'none'
  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 Slack
  slack:
    token: thetoken/generatedby/slack
    msg: '{{ inventory_hostname }} is alive!'
    color: good
    username: ''
    icon_url: ''

- name: Use the attachments API
  slack:
    token: thetoken/generatedby/slack
    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

- name: Send a message with a link using Slack markup
  slack:
    token: thetoken/generatedby/slack
    msg: We sent this message using <https://www.ansible.com|Ansible>!

- name: Send a message with angle brackets and ampersands
  slack:
    token: thetoken/generatedby/slack
    msg: This message has &lt;brackets&gt; &amp; ampersands in plain text.

Статус

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

Автор

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.5/modules/slack_module.html