Post commit Webhook

The Opsera Pipeline supports webhook based start events for GitLab, GitHub and Bitbucket.

With this functionality user can manage what branches the trigger event will occur off of. User can select a primary and secondary branch in this form and any time a commit occurs on one of these branches, the pipeline will be triggered. This document will outline the steps needed to configure a webhook & also show how to trigger a pipeline using the webhook.

Steps to configure Webhook in pipelines

• Login into the Opsera Portal and Navigate to any pipeline where webhook is needed. Go to Workflow tab as show below.

Open

• On the workflow configuration, Click on the gear icon from ‘Start of Workflow’ pipeline step

Open

• Source Repository configuration form will open.

• Select a source repository management Platform from the drop down. Choose from GitLab, GitHub or Bitbucket.

• Upon selecting a Platform, corresponding accounts stored in the Tool Registry will be fetched and provided in the Account drop down. Select the account containing the project you wish to configure your webhook trigger events to.

• Once the Account is selected, a list of Repositories and then Branches will be fetched and provided in drop downs. Select the Repository of your project and then select a Primary Branch. You have the option to select a Secondary Branch as well. Once the webhook is successfully registered in the following steps, this pipeline will be triggered any time a commit occurs on the selected Primary and Secondary Branch.

Webhook Registration

• Enable the ‘Trigger Active’ toggle to proceed with webhook registration.

• Complete webhook registration by copying the webhook URL shown. In your SCM account’s webhook settings, paste the copied webhook URL:
  
  Bitbucket:

GitLab:

How to trigger Webhook in pipelines

Here are the steps show a successful trigger of an Opsera Pipeline via commit on the SCM tool -

branch after the successful Webhook configuration.

• Commit has been made on the SCM Tool - branch

• Opsera pipeline is triggered automatically, after a commit has been made on the selected Branch or Branches.

• The same can also be verified with SCM Tool – Webhook history page – where a successful commit event trigger will be registered

The above steps indicate the successful configuration and trigger of Post commit Webhook.

Pipeline Orchestration and Queuing

If a pipeline is already running and another webhook request comes in, the webhook request will be logged in the Pipeline Logs as part of the current run and the pipeline run request will be queued. Once the current run is successful, the pipeline will run a second time.

The following will display when a pipeline has been triggered as the result of a webhook event:

Pipeline Queue:

Opsera Pipelines support queuing of runs when the pipeline is currently in progress.

If a webhook event is triggered while the pipeline is already running, the second webhook event will trigger a queue request within the same run. Even if multiple webhook events are triggered due to new commits being made on the branch during a pipeline run, there will still only be one subsequent run, and the latest commit will always be used. The following will display in the Pipeline Activity Log:

The green ‘Repeat Once’ button will change to ‘Queued Request’

Note: The queued run will ONLY run if the prior pipeline is successful. If prior pipeline fails the queued request will not run.

Cancel a queued request:

1. To cancel a queued request, click on the grey ‘Queued Request’ button.

2. The following pop up will appear:

3. Click ‘Cancel Queue Request’ button. This will clear the pending run request and end the pipeline after the current run.