jenkins 实现gitbook项目（电子书）的自动发布

jenkins 系列文章，包含效果演示（2021-01-25 10:10:25 效果演示到期，轻量应用服务器只申请了试用2个月时间）以及实现说明：
jenkins实现 windows server 2012环境下自动部署war
jenkins实现Centos 7 下自动部署war
jenkins 实现gitbook项目（电子书）的自动发布
jenkins 实现源码到docker镜像的自动部署运行

---

接上一篇 jenkins实现Centos 7 下自动部署war
现在来动手实现Centos7 系统下gitbook项目的自动发布。

老规矩，先看效果，再来谈实现！
控制台地址1： https://jks.00fly.online/job/gitbook-docker/
控制台地址2： https://jks.00fly.online/job/gitbook-nginx/
项目源码： https://gitee.com/00fly/gitbook
项目地址： https://book.001fly.top/

效果展示

• gitbook源码有提交发生时，会触发jenkins控制台任务的运行，触发机制为每5分钟检测一次git源码提交
  通过查看任务的运行时间，我们可以判断这3个时间段内有代码提交，结合代码git提交记录也印证了这种判断。
  通过查看发布网站对照提交代码也说明gitbook内容也实现了同步自动更新。
  

Jenkins 任务配置说明

jenkins的安装请参考 jenkins实现Centos 7 下自动部署war 里面的相关内容。

新建任务时选择如图自由风格软件项目。

其他配置值如下

设置构建的保持时间

设置git源码参数

设置任务触发条件

设置构建步骤

这里设置命令打包book目录，docker-compose.yml 文件到gitbook.tar

设置ssh参数以及远程执行的shell

这里设置连接到名为light的服务器，将tar上传到/work/gitbook目录下解压缩，并执行docker-compose 重启命令。

上面是gitbook-docker任务的配置，gitbook-nginx任务的配置主要区别在于构建执行命令的不同。

两种命令对比如下：

cd  /work/gitbook && tar zxvf gitbook.tar  && docker-compose restart 

cd  /work/gitbook && tar zxvf gitbook.tar  && docker-compose up -d && docker-compose down

大家可以想一想这两种实现的区别是什么？ 下面来解释下！
方式1
docker-compose restart
实现了gitbook容器的重启，重启过程中实现了电子书的重建和运行。

方式2
docker-compose up -d && docker-compose down
实现了gitbook容器的启动，启动完成后立即关闭。

方式1和方式2分别对应了gitbook的2种运行方式：

• gitbook serve 运行
• nginx静态文件代理

针对nginx静态文件代理方式，有2种方式：

• jenkins服务器端将源文件运行 gitbook build 生成静态文件，静态打包后上传到网站服务器
• jenkins服务器端将源文件打包上传到网站服务器，网站服务器运行 gitbook build 生成静态文件

生成静态文件有2种方式：

• 服务器运行脚本命令 gitbook build

• docker镜像运行 docker-compose restart 或 docker-compose up -d

  也就是说jenkins服务器生成静态文件和网站服务器生成静态文件各有2种方式，一共有4种方式来部署运行gitbook电子书程序，大家可以自己分别调试，加深理解！

  最新消息， jenkins服务端gitbook build 生成静态文件已经实现

---

写的仓促，不足之处，欢迎大家提问！