GitHub中的gitbook项目部署在Jenkins中，执行git push命令时自动执行Jenkins构建

环境准备

获取GitHub的Personal access token

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

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

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

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

接下来对Jenkins项目进行配置

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

选择Git
Repository URL输入仓库地址：https://github.com/Mingyue12345/OpenAPI-doc.git
Credentials创建一个Credentials，类型选择Username with password，Username输入GitHub账号，Password输入GitHub密码，描述随便输入，如下图
源码库浏览器选择githubweb
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的项目可以这样配置，详细介绍如下：

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

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

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