Manage Pull Requests (PR) or Merge Requests in DevOps Change Velocity
Manage Jenkins, GitHub Actions, and Azure DevOps (ADO) pipeline’s pull requests for GitHub, Bitbucket, and ADO coding sources from ServiceNow DevOps. You can enable the change approval process on your pull request to control pull request merge approvals from ServiceNow DevOps and monitor pull request details associated with the change request.
Before you begin
Ensure that the following prerequisites are met before approving pull requests:
- Your admin has created a pull request branch in GitHub or Bitbucket using a Multi-branch project pipeline. For more information, see GitHub branch source and Bitbucket branch source.
- Your admin has enabled pull request creation in the ADO repository. For more information, see https://marketplace.visualstudio.com/items?itemName=ShaykiAbramczyk.CreatePullRequest.
- Your admin has configured Jenkins integration with DevOps. For more information, see Jenkins integration with DevOps.
- Your admin has configured GitHub integration with DevOps. For more information, see GitHub integration with DevOps.
- Your admin has configured Bitbucket integration with DevOps. For more information, see Bitbucket integration with DevOps.
- Your admin has configured ADO integration with DevOps. For more information, see Azure DevOps integration with DevOps Change Velocity.
- Your admin has enabled the Change Acceleration feature of DevOps for automatic change request creation in your pipeline. For more information, see Accelerating DevOps change.
Role required: sn_devops.admin
About this task
For Jenkins pipelines, pull requests can be managed for GitHub and Bitbucket coding sources.
For GitHub Actions pipelines, pull requests can be managed for GitHub coding source.
For ADO pipelines, pull requests can be managed for ADO coding source.
Procedure
Create a pull request in GitHub or Bitbucket or ADO.
For more information, see Creating a pull request or Create a pull request to merge your change.
Perform the following steps based on your orchestration tool.
| Orchestration tool | Steps |
|---|---|
| Jenkins |
|
| GitHub Actions |
|
| ADO |
Pull request tracking will be enabled for all the existing configured projects. For any project that is not configured, you must configure them for pull requests to be tracked. |
Run the pull request pipeline in Jenkins, GitHub Actions, or ADO.
A build is initiated and a change request notification is sent to the approver associated with the pipeline.
Navigate to DevOps > Orchestrate > Pipeline Change Requests.
Select the change record associated with the pull request.
Approve the change request associated with the pull request by selecting Approved in the State field.
Merge is enabled in GitHub or Bitbucket or ADO for the pull request. Merge the pull request in the corresponding tool.
Select the Pull Requests related list associated with the change record.
View the pull request details by clicking the pull request number corresponding to the Number field.
Pull request details associated with a change record for a Jenkins pipeline
All the pull request details \(including the details after the request is merged\) associated with the change record are displayed. Details such as Pull request ID, Commits, Origin branch, Destination branch, Raised by, Approver, Comments, PR raised time, PR approved time, PR merged/closed time are displayed. Commits from pull requests are shown in the **Commits** related list.
- **Limitation**
Details of pull requests that are created in a BitBucket coding source and associated with a Jenkins pipeline are not displayed for a change request.
Parent Topic:Accelerating your DevOps change process