For teams using Slack or Microsoft Teams, it's possible to set up notifications to stay informed about your pipeline and any of the associated PRs within it.
How does it work?
Notifications can be set up so that your team is informed of important events that happen within your pipeline and require action from a team member. These are:
Validations
Deployments
Merge Conflicts
You can choose to be notified about one or more of these events, and specifically what event triggers a notification.
How do I configure it?
1) When looking at your pipeline, access the settings by clicking the cog in the top right and selecting Edit pipeline details...
2) In the pop up window, select the "Notifications" tab.
3) Select the Add notification
button to set up your first configuration.
You will be shown the following screen
4) Select the environment(s) that you wish to receive notifications about.
5) Choose the specific event(s) that you wish to be notified about. These can be validations only, deployments only, validations and deployments, or merge conflicts. For validations and deployments, you can choose whether to be notified about successes, failures or both.
โ
6) Select whether you are using Slack or Microsoft Teams and paste in the integration URL for the specific channel you wish to receive the notifications in.
Slack: Instructions here
Teams: Instructions here
7) Enter a friendly name to identify this notification in future, for example you may want to enter the name of the channel to where the notifications will be sent.
8) Press Save Notification
to save the notification and start receiving notifications
What's the result?
You will start to receive notifications based on your configuration.
In the case of validation errors or merge conflicts, you can click your PR name in the notification and be directly linked to the PR in your pipeline.
How do I edit a notification?
1) When looking at your pipeline, access the settings by clicking the cog in the top right and selecting Edit pipeline details...
2) In the pop up window, select the "Notifications" tab.
3) Click the blue pencil icon next to the notification you wish to delete
4) Edit the notification as appropriate, see "How do I configure it?" for an explanation of the options
5) Press Save Notification
to save the changes or press Back to notifications
to return to the list
How do I delete a notification?
1) When looking at your pipeline, access the settings by clicking the cog in the top right and selecting Edit pipeline details...
2) In the pop up window, select the "Notifications" tab.
3) Click the red bin icon next to the notification you wish to delete
4) Press Delete notification
to confirm deletion of the notification