Building projects based on pull request is something you cannot avoid in CI/CD pipelines. Nowadays every team does several deployments/operations per day and lots of builds have to happen in this process.
Also, the teams work on the same repo collaborating code require faster code integrations. So it is better to have an automated build process that kicks off the CI/CD pipeline on a pull request rather than manually triggering the jobs.
Trigger Builds Automatically On Github Pull Request
In this tutorial, we will explain how to configure a pull request based build trigger on Jenkins using Github webhooks and Github pull request builder plugin.
Note: Multipbranch Pipeline is the best way to achieve Jenkins pull request based workflow as it is natively available in Jenkins. Check out this article on the multibranch pipeline for setup and configuration.
Install Github Pull Request Builder Plugin
- Go to
Manange Jenkins --> Manage Plugins
Click on the
available
tab at the top and search forGithub Pull Request Builder
. Select the plugin using the checkbox and clickInstall without restart
as shown in the image below.- Once the plugin is installed, select the restart checkbox as shown in the image below.
Github Pull Request Builder Configuration
Once Jenkins is restarted, follow the steps given below for configuring the plugin with your GitHub account.
- Head over to
Manange Jenkins --> Configure System
- Find "GitHub Pull Request Builder" section and click add credentials.
- Enter your Github username and password and add it.
- You can test the Github API connection using the test credentials button. It should show "connected" as shown below. Save the configuration after testing the API connection.
Github Repo Webhook Configuration
For Jenkins to receive PR events through the pull request plugin, you need to add the Jenkins pull request builder payload URL in the Github repository settings.
- Go to Github repository settings, and under webhooks, add the Jenkins pull request builder payload URL. It has the following format
http://<Jenkins-IP>:<port>/ghprbhook/
If you need just the PR triggers, you can select the "Let me select individual events" option and select just the "Pull requests" option. Save the webhook after selecting the required events.
- Once saved, go back to the webhook option and see if there is a green tick. It means Github is able to successfully deliver the events to the Jenkins webhook URL.
Job Configuration for Automated Pull Request Builds
Lets get started with the build job configuration for PR plugin.
- Under the General tab, select Github project option and enter the Github repo URL for which you want the PR builds without .git extension as shown below.
- Click advanced option and enable automatic PR build trigger and add the target branches you would raise the PR for.
- Add your pipeline build steps and save the configuration.
- Now raise a PR against the whitelisted branch you have given in the Jenkins PR trigger settings. You should see the job getting triggered on Jenkins.
Other Jenkins PR based Build Workflows
Github Pull request builder plugin is not actively developed as the same functionality is being provided by multi-branch pipelines and Github organisation project.
There is also a Generic Webhook Plugin that can be used to trigger Jenkins jobs on a Pull Request.
Also, you can write custom API endpoints that accept Github webhooks and process PR requests to trigger Jenkins job remotely. Custom APIs help only when the native Jenkins functionalities are not providing the workflow you are looking for.