Child pages
  • GitHub pull request builder plugin

Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Next »

This plugin builds pull requests in github and report results.

Plugin Information

View GitHub Pull Request Builder on the plugin site for more information.

The current version of this plugin may not be safe to use. Please review the following warnings before use:

Older versions of this plugin may not be safe to use. Please review the following warnings before using an older version:

When a new pull request is opened in the project and the author of the pull request isn't whitelisted, builder will ask "Can one of the admins verify this patch?" and one of the admins comment "this is ok to test" to add the author to the whitelist.

If an author of a pull request is whitelisted, adding a new pull request or new commit to an existing pull request will start a new build.

A new build can also be started with a comment: "retest this please".


  • Create a github 'bot' user for commenting in pull requests
  • then add the bot as a collaborator for your repository (if you are using organizations, set the Push & Pull rights for the bot).
  • Install the plugin.
  • Go to "Manage Jenkins" -> "Configure System" -> "Github pull requests builder" section.
  • Set your bot's GitHub username and password.
  • Add GitHub usernames of admins for all jobs.
  • Under Advanced, you can modify:
    • The phrase for adding users to the whitelist via comment.
    • The phrase for starting a new build.
    • The crontab line.
  • Save to preserve your changes.

Creating job:

  • Create a new job.
  • Add the project's GitHub URL to the "GitHub project" field (the one you can enter into browser. eg: "")
  • Select Git SCM.
  • Add your GitHub "Repository URL".
  • Under Advanced, set "refspec" to "+refs/pull/:refs/remotes/origin/pr/".
  • In "Branch Specifier", enter "$
    Unknown macro: {sha1}
  • Under "Build Triggers", check "Github pull requests builder".
    • Add admins for this specific job.
    • Set the crontab line for this specific job
    • Set the whitelisted users for this specific job.
  • Save to preserve your changes.

Make sure you DON'T have "Prune remote branches before build" advanced option selected, since it will prune the branch created to test this build.

If you want to manually build the job, in the job setting check "This build is parameterized" and add string parameter named "sha1". When starting build give the "sha1" parameter commit id you want to build or refname (eg: "origin/pr/9/head").



Add published URL feature.
Enable connection to github enterprise instances.
Enable authentication via a token.
When automatic merge is possible, build the merge.


Use commit status api instead of comments for reporting results.

  • No labels