关于 Jenkins master 共享 JENKINS_HOME 目录的实验

本文首发于：Jenkins 中文社区

做者：翟志军，审校：王冬辉，linuxsuren

Jenkins master 的高可用是个老大难的问题。和不少人同样，笔者也想过两个 Jenkins master 共享同一个 JENKINS_HOME 的方案。了解 Jenkins 原理的人，都会以为这个方案不可行。可是真的不可行吗？

因为工做缘由，笔者须要亲自验证以上猜测。

JENKINS_HOME 介绍

Jenkins 全部状态数据都存放文件系统的目录中，这个目录被称为 JENKINS_HOME 目录。

实验环境介绍

笔者经过 Docker compose 启动两个独立的 Jenkins master，分别为 jenkins-a 和 jenkins-b。它们共用同一个 JENKINS_HOME 目录。相应的代码仓库的连接放在文章底部。

将代码克隆到本地后，进入仓库，执行 docker-compose up -d 便可启动实验环境。启动完成，在浏览器中输入 http://localhost:7088 可访问 jenkins-a，jenkins-b 的地址是 http://localhost:7089 。可是你会发现它们启动后的界面显示是不同的。

jenkins-b 的界面以下图所示：

而 jenkins-a 的界面以下图所示：

这时，将 jenkins-a 日志中的解锁密码（Unlock password）输入到 jenkins-b 的页面中，会获得报错信息：

ERROR: The password entered is incorrect, please check the file for the correct password
复制代码

这时，再次 jenkins-b 日志中的解锁密码（Unlock password）输入到表单中便可进入下一步。接下来就是按照提示一步步完成了。在 jenkins-b 安装步骤的最后一步，咱们设置了管理员的用户名密码：admin/admin。而后就算完成任务了。

而后咱们再在 jenkins-a 使用 admin/admin 进行登陆，登陆是报错的：用户密码不正确。

接下来，执行 docker-compose restart jenkins-a 命令重启 jenkins-a。再次使用 admin/admin 就能够登陆成功了。

当两个 Jenkins 启动完成后，接下来开始作实验。

实验1：建立任务

在 jenkins-a 建立任务 x，刷新 jenkins-b 的页面，jenkins-b 上会不会显示出任务 x ？

结果：jenkins-b 不会出现任务 x。重启 jenkins-b 后，任务 x 出如今任务列表中。

实验2：任务结果可见性

jenkins-a 上任务执行，jenkins-b 上可否看到任务执行结果？

jenkins-a 执行任务 x，而且执行成功。刷新 jenkins-b 看不到任何执行记录。重启 jenkins-b 后，可看到执行记录。

实验3：两 master 同时执行同一任务

分别在两个 Jenkins master 上（几乎）开始同一个任务 x。其中一个任务的 build number 会更新，可是另外一个不会。

其中 jenkins-a 任务 x 的 build number 会升到 2，而 jenkins-b 保持的是 1。这时，单独执行 jenkins-b 的任务 x，日志会出现错误：

jenkins-b_1  | WARNING: A new build could not be created in job x
jenkins-b_1  | java.lang.IllegalStateException: JENKINS-23152: /var/jenkins_home/jobs/x/builds/2 already existed; will not overwrite with x #2
复制代码

实验4：编辑任务

jenkins-a 上设置任务 x 定时执行，刷新 jenkins-b 页面，任务 x 中并无定时执行的设置。重启 jenkins-b 后，任务 x 更新。

实验5：定时任务的结果是什么？

若是 jenkins-a 和 jenkins-b 两个任务均为定时任务，并且都生效了。它们运行结果是什么的呢？

看到的现象是，两个任务都会按时执行，可是只有一个任务能将运行结果写入到磁盘中。界面以下图：

另，从日志中，能够确认 jenkins-a 和 jenkins-b 确实按时执行了。以下图日志中，看出 jenkins-a 定时执行 #6 次构建时报错，由于 jenkins-b 已经执行过 #6 次构建了：

小结

能够确认的是，当两个 Jenkins 进程共用同一个 JENKINS_HOME 目录时，其中一个 Jenkins 进程更新了 JENKINS_HOME 的内容，另外一个是不会实时更新的。因此，同时启动两个 Jenkins master 共用同一个 JENKINS_HOME 的方案是不可行的。咱们不能在 jenkins-a 挂了后，直接将流量切到 jenkins-b。由于 jenkins-b 必须重启。

最后结论：多个 Jenkins master 共享同一个 JENKINS_HOME 的方案是没法使用 Jenkins master 的高可用。

附录

• Jenkins standby 实验环境：github.com/zacker330/j…