Jenkins Automated Build Trigger On Github Pull Request

jenkins github pr integration

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

  1. Go to Manange Jenkins --> Manage Plugins
  2. Click on the available tab at the top and search for Github Pull Request Builder. Select the plugin using the checkbox and click Install without restart as shown in the image below.github pull request builder plugin
  3. Once the plugin is installed, select the restart checkbox as shown in the image below.jenkins plugin restart

Github Pull Request Builder Configuration

Once Jenkins is restarted, follow the steps given below for configuring the plugin with your GitHub account.

  1. Head over to Manange Jenkins --> Configure System
  2. Find “GitHub Pull Request Builder” section and click add credentials.Jenkins - Github connectivity
  3. Enter your Github username and password and add it. jenkins - github credentials
  4. 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.pull request builder credentials configuration

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.

  1. Go to Github repository settings, and under webhooks, add the Jenkins pull request builder payload URL. It has the following format
    github jenkins webhools settings

    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.add webhook in github for jenkins

  2. 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.github activated webhook

Job Configuration for Automated Pull Request Builds

Lets get started with the build job configuration for PR plugin.

  1. 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.jenkins github repo URL
  2. Click advanced option and enable automatic PR build trigger and add the target branches you would raise the PR for.PR build target branches
  3. Add your pipeline build steps and save the configuration.
  4. 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.

  1. i have follow same steps but not working
    in github pass request I have see in webhook but jenkins not able to get that

    1. @ronak Multipbranch Pipeline is the best way to achieve Jenkins pull request based workflow as it is natively available in Jenkins

  2. What if I am just testing the jenkins ? It is not deployed and it isn’t reachable over the public Internet. Is there still a way to configure this ?

  3. Is it possible to get the pull request number during the build? I want to use in the execute shell section.

    1. yes. It is. ghprbPullId variable should be having the PR number

      Following variables are supported


      1. @devopscube:disqus Thanks!.
        Also, is it possible to update the PR before starting the build.
        For example, let’s say my PR branch is not updated with the base branch (on which the PR has been raised). Can this plugin update the PR with the base branch as in merge base branch into PR branch and then checkout the PR branch and start it’s build?
        There’s one ‘Merge before build’ option available but that doesn’t achieve this.

  4. I created a pull request on my repo but it did not trigger any jenkins job,However i follwed the same step.

  5. I’m confused, GPRB is no longer maintained and hasn’t been for awhile, but this article is not that old. The GPRB page says to use GitHub Branch Source plugin instead, but I can’t find an explanation of how to use GBS to do the same thing

  6. when i submit a PR git should trigger job , create a branch and merge code from origin branch to upstream branch ensure the conflicts also , perform the build on temp branch ensure the build works with latest and merged code. and Post build it should run Unit Test cases
    and after Post Unit Test Case it should run sanity test

    Can you tell me how we do .

  7. Jenkins triggering when create pull request as well jenkins triggering the build when user git commit the code. How to avoid this? I dont want jenkins trigger for each commit.

Leave a Reply

Your email address will not be published. Required fields are marked *

You May Also Like