配置GitHub Push自动触发Jenkins的构建

这里以gitbook的项目为例，GitHub中的gitbook项目部署在Jenkins中，执行git push命令时自动执行Jenkins构建，其他项目只是最后的执行脚本不同

环境准备

1. 安装Jenkins，详情见Jenkins安装
2. 配置Jenkins插件，Git，GitHub的一些相关插件
3. 安装gitbook，见gitbook 安装，如果你的项目不是gitbook的，这个可以不用安装

获取GitHub的Personal access token

1. 进入GitHub，点击setting，进入setting页面，点击左下角的Developer settings，如下图：
   
2. 跳转到”Developer settings”页面后，点击左下角的Personal access tokens，如下图：
   
3. 跳转到”Personal access tokens”页面后，点击右上角的Generate new token按钮，如下图：
   
4. 可能会提示输入GitHub密码，输入后跳转到创建token的页面，如下图所示，随便输入Token description，再勾选repo和admin:repo_hook，再点击底部的Generate token按钮，就能产生一个新的access token，将此字符串复制到记事本，后面jenkins任务中会用到（注意：关闭这个页面就找不到这个字符串了）：
   

配置Jenkins

1. 进入系统设置：
   
2. 在系统设置页面找到”GitHub”，点击添加GitHub Server，如下图，名称随便起，API URL填写https://api.github.com，凭据位置如下图红框所示，选中管理 Hook选择Add ->Jenkins：
   
3. 弹出的页面中，类型选择Secret text，Secret填入前面在GitHub上生成的Personal access tokens，描述随便写一些描述信息，点击添加完成添加.如下图：
   
4. 填写完毕后，点击右侧的连接测试按钮，如果信息没有填错，显示的内容如下图所示：
   
5. 点击页面最底部的保存按钮

GitHub的项目主页和仓库地址

项目主页和仓库地址是不同的，如下图，红框1中是项目主页，点击红框2的按钮后，红框3中是仓库地址（要用HTTPS的，不用SSH 的）：

我的项目主页：https://github.com/Mingyue12345/OpenAPI-doc

我的仓库地址：https://github.com/Mingyue12345/OpenAPI-doc.git

Jenkins中新建构建项目

在Jenkins上新建一个名为 “openapi-doc” 的项目

接下来对Jenkins项目进行配置

源码管理设置

上图中每个红框的设置如下解释：

1. 选择Git
2. Repository URL输入仓库地址：https://github.com/Mingyue12345/OpenAPI-doc.git
3. Credentials创建一个Credentials，类型选择Username with password，Username输入GitHub账号，Password输入GitHub密码，描述随便输入，如下图
4. 源码库浏览器选择githubweb
5. URL输入项目主页：https://github.com/Mingyue12345/OpenAPI-doc

构建触发器

构建触发器中勾选GitHub hook trigger for GiTScm polling，如下图

构建环境和绑定

如下图所示，勾选Use secret text(s) or file(s)，下面的”凭据”选择我们之前配置过的Personal access tokens

构建

设置构建脚本，这里选择 执行 Shell，gitbook的项目可以这样配置，详细介绍如下：

1. 执行gitbook build生成静态页面
2. 将_book文件夹下的所有文件复制到tomcat安装目录的/webapps/test/
3. 浏览器访问tomcat服务器的http://ip:8080/test就可以查看这个书籍了

配置GitHub的webhook地址

webhook是通知Jenkins时的请求地址，用来填写到GitHub上，这样GitHub就能通过该地址通知到Jenkins；
假设登录Jenkins的地址是： http://192.168.0.1:8080/jenkins，那么webhook地址就是 http://192.168.0.1:8080/jenkins/github-webhook

1. 登录GitHub，进入要本次构建用到的工程；
2. 在工程主页面点击右上角的Settings，再点击左侧Webhooks，然后点击Add webhook，如下图：
   
3. 在Payload URL位置填入webhook地址，再点击底部的Add webhook按钮，这样就完成webhook配置了，今后当前工程有代码提交，GitHub就会向此webhook地址发请求，通知Jenkins构建

测试

可以先在Jenkins的项目页面点击立即构建手动执行一下构建，如果成功的话，可以测试一下执行push命令以后能不能自动构建