Azure Pipelines app on Microsoft Teams enables you to monitor the events for your pipelines. You can set up and manage subscriptions for releases, pending approvals, completed builds etc. and get notifications right into your Teams channel for these updates. You can also approve releases from within your Teams channel or on the go via a Teams mobile app.
Adding Azure Pipelines app to your team
You can install Azure Pipelines app from Microsoft Teams app store. Once the app is installed you have to connect the app to the pipelines you want to monitor. App would ask you to sign in and authenticate to Azure Pipelines before running any commands
Azure Pipelines Commands
Below is the list of all the commands that are supported for Azure Pipelines app
- @azure pipelines subscribe [pipeline url] - Subscribe to a pipeline to receive notifications
- @azure pipelines subscriptions - Add or remove subscriptions for this channel
- @azure pipelines feedback - Report a problem or suggest a feature
- @azure pipelines help - Get help on the slash commands
- @azure pipelines signin - Sign into your Azure Pipelines account
- @azure pipelines signout - Sign out from your Azure Pipelines account
Subscribing for notifications
To start monitoring a pipeline, use the following command inside a channel: ‘@azure pipelines subscribe [pipeline url]’. The pipeline URL can be to any page within your pipeline that has a definitionId or buildId/releaseId present in the URL.
Below are example for commands you can use for build and release pipelines:
- Build pipelines: ‘@azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123’
- Release pipelines: ‘@azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases’
If you end up putting a wrong URL, bot will notify you and would ask for the correct URL. For Build pipelines, the channel is subscribed to the Build completed notification, and for Release pipelines, the channel is subscribed to the Release deployment started, Release deployment completed, and Release deployment approval pending notifications.
Managing subscriptions
Use the following command to view all the current subscriptions for the channel – ‘@azure pipelines subscriptions’. This is also the command to use to add new subscriptions with more filters, subscribe to new events like Release created or to remove existing subscriptions from the channel.
Approving release deployments
You can approve release deployments from notification card within your channel without navigating to the Azure Pipelines portal. Once you subscribe to any release pipeline you’ll start receiving release deployment approval pending notification in your channel.
Whenever a deployment is pending for approval, a notification card with options to approve or reject the deployment is posted in the channel. Users can then review the details of the deployment in the notification and take action.
The app supports all of the approval scenarios present in the Azure Pipelines portal, like single approver, multiple approvers (any one user, any order, in sequence), and teams as approvers. You can approve deployments as an individual or on behalf of a team.