这里以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，如下图：
   image
3. 在Payload URL位置填入webhook地址，再点击底部的Add webhook按钮，这样就完成webhook配置了，今后当前工程有代码提交，GitHub就会向此webhook地址发请求，通知Jenkins构建

测试

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