salt.returners.slack_webhook_return

Return salt data via Slack using Incoming Webhooks

codeauthor:

Carlos D. Álvaro <github@cdalvaro.io>

The following fields can be set in the minion conf file:

slack_webhook.webhook (required, the webhook id. Just the part after: 'https://hooks.slack.com/services/')
slack_webhook.success_title (optional, short title for succeeded states. By default: '{id} | Succeeded')
slack_webhook.failure_title (optional, short title for failed states. By default: '{id} | Failed')
slack_webhook.author_icon (optional, a URL that with a small 16x16px image. Must be of type: GIF, JPEG, PNG, and BMP)
slack_webhook.show_tasks (optional, show identifiers for changed and failed tasks. By default: False)

Alternative configuration values can be used by prefacing the configuration. Any values not found in the alternative configuration will be pulled from the default location:

slack_webhook.webhook
slack_webhook.success_title
slack_webhook.failure_title
slack_webhook.author_icon
slack_webhook.show_tasks

Slack settings may also be configured as:

slack_webhook:
  webhook: T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
  success_title: '[{id}] | Success'
  failure_title: '[{id}] | Failure'
  author_icon: https://platform.slack-edge.com/img/default_application_icon.png
  show_tasks: true

alternative.slack_webhook:
  webhook: T00000000/C00000000/YYYYYYYYYYYYYYYYYYYYYYYY
  show_tasks: false

To use the Slack returner, append '--return slack_webhook' to the salt command.

salt '*' test.ping --return slack_webhook

To use the alternative configuration, append '--return_config alternative' to the salt command.

salt '*' test.ping --return slack_webhook --return_config alternative
salt.returners.slack_webhook_return.event_return(events)

Send event data to returner function :param events: The Salt event return :return: The result of the post

salt.returners.slack_webhook_return.returner(ret, **kwargs)

Send a slack message with the data through a webhook :param ret: The Salt return :return: The result of the post