| Table of Contents | ||||
|---|---|---|---|---|
|
Pipelines Approval Gate Configuration
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 to the Approval Gate pipeline step. Use the following documentation as a guideline to configuring an Approval Gate pipeline step, configuring a Pipeline Notification to the step, then approving through the respective platform or in Opsera’s UI.
| Table of Contents | ||||
|---|---|---|---|---|
|
...
Pipelines Approval Gate Configuration
Use the following documentation as a guideline to configuring an Approval Gate pipeline step.
| Info |
|---|
Prerequisites - In order to configure approval gate step for Slack, MS Teams, Jira, Service Now, or Google Chat, ensure you have created a respective tool in Tool Registry with a valid connection. You must also configure a notification to the approval gate step. |
Approval Gate 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 Configurations and add 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.
Pipelines Notification Configuration
...
| Note |
|---|
To complete Approval Gate step configuration you must configure the pipeline notification to the Approval Gate step. |
...
Pipeline Step Notification Configuration
To configure notifications for a pipeline step, navigate to the pipeline Workflowand click the pencil icon (✏️) in the pipeline step. To configure an Approval Gate, configure the notifications in a configured Approval Gate pipeline step. This will open the Pipeline Step Notification Configuration popup.
Provide Approval Gate Flow Setup & Notification Setup for the following:
Slack
| Info |
|---|
Prerequisite - In addition to having a successfully configured Slack tool in the Tool Registry, the Opsera app must be added to the Slack channel where notifications will be received. |
Add the Opsera App to a Slack Channel
To receive a notification within a specific Slack channel, navigate to the slack channel. In the text field, type “/app” to search through your connected app directory and locate Opsera. Click Add apps to this channel.
Locate Opsera and click Add. The Opsera app has been added to the Slack channel and can be configured in Notifications.
Slack Notification Configuration
...
Email Notification Configuration
Click Email from the left hand panel to configure Slack Email Notifications.
Enable the Slack Email Notifications toggle.
Provide the following values:
Email Address - Enter the email address where you would like to receive notifications. Once the email is entered, click +Add Email Address. You can select up to five Email Addresses.
Notification Level - Select the scenario which you want to be notified from the drop-down. Choose from Step Completed, On Error, or All Activity.Slack Tool - Select the correctly configured Slack tool from the drop-down.
Slack Channel - Provide the name of the slack channel where you previously added the Opsera app. The # is not required.
Click Save. The Slack Email Notification is now configured. Notifications will now be sent to this Slack channel the email(s) provided when the selected conditions are met.
Jira Notification Configuration
This area will contain information on how to successfully configure a Jira notification.
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.
...
...
Google Chat Notification Configuration
Fetching Webhook URL from Google chat:
Click on the chat to receive notifications → Manage Webhooks → Copy the URL → enter it in Opsera Tool registry.
...
Tool Registry:
Login Opsera Portal → Tool Registry → Create new Tool → Select Google chat & Create
Enter the Webhook URL in Connection details & check “Test Connection”
...
To enable the notification from Pipeline/Task:
Click the step notification Icon to open Pipeline step Notification Configuration
Click Google Chat from the left hand panel to configure Email Slack Notifications.
Enable the Email Gchat Notifications toggle.
Provide the following values:
Email Address - Enter the email address where you would like to receive notifications. Once the email is entered, click +Add Email Address. You can select up to five Email Addresses.
Notification Level - Select the scenario which you want to be notified from the drop-down. Choose from Step Completed, On Error, or All Activity.
GChat Tool - Select the correctly configured Slack tool from the drop-down.
Sample Gchat notification message:
...
Service Now Notification Configuration
This area will contain information on how to successfully configure a Service Now pipeline notification.
Slack Notification Configuration
| Info |
|---|
Prerequisite - In addition to having a successfully configured Slack tool in the Tool Registry, the Opsera app must be added to the Slack channel where notifications will be received. |
Add the Opsera App to a Slack Channel
To receive a notification within a specific Slack channel, navigate to the slack channel. In the text field, type “/app” to search through your connected app directory and locate Opsera. Click Add apps to this channel.
Locate Opsera and click Add. The Opsera app has been added to the Slack channel and can be configured in Notifications.
Slack Notification Configuration
...
Click Slack from the left hand panel to configure Slack Notifications.
Enable the Slack Notifications 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.
.
Slack Tool - Select the correctly configured Slack tool from the drop-down.
Slack Channel - Provide the name of the slack channel where you previously added the Opsera app. The # is not required.
Include last 10 lines of log (limited to 1000 characters) - Enable the toggle in order to view logs appended with Slack notification for Step Completed, On Error, or All Activity and for approval gate step to append logs from all the prev steps in pipeline
Click Save. The Email Slack Notification is now configured. Notifications will now be sent to the email(s) provided this Slack channel when the selected conditions are met.
Service Now
Google Chat
...
Approval Gate Approval/Rejection
Once the above Approval Gate step and pipeline notification has been properly configured and the running pipeline reaches the step, the configured Teams tool channel will receive a notification.
User will receive a notification via the selected Microsoft Teams channel. Approve or Reject either within the channel UI or within the Opsera portal.
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
At this time Approval Gate step is not supported by Google Chat tool. |
Teams Approval
...
Approval through the Opsera Platform
...