GitHub pull request时Jenkins自动构建教程

当开发人员向GitHub的master分支提交pull request时，需要相关的人员进行review后，才merge到master分支。通过Jenkins，可以很方便的实现pull request时自动触发构建、测试代码，极大的提高工作效率。下面简单介绍一下配置步骤。

1.生成Token

GitHub上点击个人头像，依次选择Settings > Developer settings > Personal access tokens, 点击Generate new token按钮进入新Token生成页面。

勾选下图所示的选项，然后单击页面下方的Generate token按钮生成Token.

注意：将生成的Token复制保存，后面你就无法再看到它了。

Jenkins > 系统管理 > 管理插件 > 可选管理，搜索GitHub Pull Request Builder，然后选择直接安装

在Jenkins中添加Credentials，Kind处选择Secret text, Secret处填写GitHub的Token，后面配置GitHub Pull Request Builder时需要用到它。

然后再使用GitHub的用户名和密码创建另一个Credentials，后面配置任务的时候会用到。当然如果你已经添加过了，就不用再配置。

然后在 jenkins > 系统管理 > 系统设置 > GitHub Pull Request Builder如下配置

GitHub Server API URL: 默认为 https://api.github.com , 企业版填写 https://域名/api/v3/。
Credentials: 选择之前用GitHub生成的token创建的Credentials。

填好上面的内容后，可以通过下方的Connect to API 按钮验证连接GitHub是否正常，Check repo permissions按钮验证权限。

新建一个自由风格的任务，然后配置该任务

将项目的GitHub URL添加到GitHub project处(可以输入到浏览器中的项目，例如https://github.com/janinko/ghprb)

在配置源码管理中添加代码在GitHub中的地址，Credentials处选择上面用GItHub的账号和密码创建的Credentials。

refspec：
- 如果只想构建PR，请将refspec设置为+refs/pull/${ghprbPullId}/*:refs/remotes/origin/pr/${ghprbPullId}
- 如果你想构建PR和分支，请将refspec设置为 +refs/heads/*:refs/remotes/origin/* +refs/pull/${ghprbPullId}/*:refs/remotes/origin/pr/${ghprbPullId}/
Branch Specifier: 填写 ${sha1}, 如果想要用到提交的pr，则这个地方填写 ${ghprbActualCommit}