Using Slack hooks
It is possible to use Slack to send notifications to your Slack channel whenever an apply is being done.
NOTE
Currently only apply
events are supported.
For this you'll need to:
- Create a Bot user in Slack
- Configure Atlantis to send notifications to Slack.
Configuring Slack for Atlantis
- Go to https://api.slack.com/apps
- Click the
Create New App
button - Select
From scratch
in the dialog that opens - Give it a name, e.g.
atlantis-bot
. - Select your Slack workspace
- Click
Create App
- On the left go to
oAuth & Permissions
- Copy the
Bot User OAuth Token
and provide it to Atlantis by using--slack-token=xoxb-xxxxxxxxxxx
or via the environmentATLANTIS_SLACK_TOKEN=xoxb-xxxxxxxxxxx
. - Scroll down to scopes and add the following:
channels:read
chat:write
groups:read
incoming-webhook
mpim:read
- Install the app onto your Slack workspace
Configuring Atlantis
After following the above steps it is time to configure Atlantis. Assuming you have already provided the slack-token
(via parameter or environment variable) you can now instruct Atlantis to send apply
events to Slack.
In your Atlantis configuration you can now add the following:
webhooks:
- event: apply
workspace-regex: .*
kind: slack
channel: my-channel
The apply
event information will be sent to the my-channel
Slack channel.