An Approval Gate step can be added to pipeline in order to obtain approval by selected user before the continuation of steps can occur. In order for this step to function correctly, you must configure a Pipeline Notification using Teams Tool to the Approval Gate pipeline step. The Pipeline Notification will be sent to the configured Teams channel. This documentation outlines how to create an incoming webhook URL in Microsoft Teams, properly configure a Teams Tool, then configure an Approval Gate and Pipeline Notification.
| Table of Contents | ||||
|---|---|---|---|---|
|
Create an Incoming Webhook in Microsoft Teams Channel
Log into Microsoft Teams and navigate to Teams in the left hand navigation.
Open the channel in which you want to to add the webhook and select … More options from the top Select … from the bottom left navigation bar.
Select Connectors from the drop-down menu.
Search for Incoming Webhook and select Add to a team.
Select Configure and provide a name to your webhook.
- Copy and save the webhook URL
Select the channel in which you will receive the notifications.
Click Set up a connector.
Provide a name for the Incoming Webhook and click Create.
Copy the URL below to save it to the clipboard, then select Save. You'll need this URL to configure the Teams tool in Opsera’s Tool Registry. Click Done.
Teams Tool Configuration
Navigate to Tool Registry and select +New Tool.
Locate the Teams tool and click Select Tool.
Provide a Tool Name and click Create.
Navigate to the Connection tab of the newly created tool.
Paste the Microsoft Teams Webhook URL in the provided field.
Click Save.
Approval Gate Pipeline Step Configuration
To add an Approval Gate step, add a new pipeline step in the pipeline Workflow. Select Approval Gate from the Tool drop-down. Click Save and close the step.
2. Click on the gear icon to open Step Settings. Add a Custom Step Message by enabling Send Custom Message toggle (optional) and provide Point of Contact.
...
3. Click Save then proceed to Pipeline Notifications Configuration.
| Note |
|---|
To complete Approval Gate step configuration you must configure the pipeline notification to the Approval Gate step. |
...
Microsoft Teams Notification Configuration
Click Microsoft Teams from the left hand panel to configure Microsoft Teams Notifications.
Enable the Microsoft Teams toggle.
Provide the following values:
Notification Level - Select the scenario which you want to be notified from the drop-down. Choose from Step Completed, On Error, or All Activity.
Teams Tool - Select the correctly configured Teams tool from the drop-down.
Click Save. The Microsoft Teams Notification is now configured. Notifications will now be sent to this Teams channel when the selected conditions are met.
...
Approval via Teams or Opsera UI
Once the above Approval Gate step and pipeline notification has been properly configured and the running pipeline reaches the step, user will receive a notification via the selected Microsoft Teams channel. Approve or Reject either within the channel UI or within the Opsera portal.
Approval via Microsoft Teams
...
Approval via Opsera
Click Approve button.
...
Add any comments, enable the Approved toggle, and click Approve button.
...
You will then receive an Approval Status message verifying that the approval has been received. The pipeline will continue to run.
...