虽然很多地方都有教程教你如何在Jenkins上连接一台windows slave,但是信息总是不全的。
以下是我在完成连接windows slave的时候碰到的一些真实问题和实践经过,在此记录下来。
Jenkins环境1:
Jenkins master 是配置在windows系统上的
Jenkins core version:2.89.2
slave也是Windows的机器
补充下Jenkins环境2:
Jenkins master用docker的方式起在linux系统上,在启动jenkins docker container的时候记得指定端口号,大家可参考如下命令:
docker run -u root --rm --name jenkins-blueocean -d -p 8080:8080 -p 50000:5000
slave还是windows的机器
前期准备工作:
一般地windows slave的启动(连接)方式有两种,如下图所示:
第一种方式“Let Jenkins control this Windows slave as a Windows service”,我记得Jenkins官网上都不大推荐,因为好像总是有问题,所以果断放弃。
第二种方式,在我的Jenkins默认配置里是没有这个选项的,需要在Jenkins -> Global Security Configure里打开,如下图所示:
接下来就是配置节点了,Jenkins -> System Configure -> Manage Slave -> New Slave
具体配置如下图:
我走了很多弯路在“Tunnel connection through”这里。以下是特别需要注意的几个点:
1. windows的防火墙要关闭(包括master和slave的),否则会导致连接失败
2. 如果防火墙一定要打开的情况,就要在Jenkins master防火墙高级设置里新建一个入站规则,如下截图步骤:
3. 需要在windows slave的机器上防火墙设置里新建端口出站规则,新建规则步骤跟入站规则类似:
4. 在slave配置中,“Tunnel connection through”,只需要填“:port”,host是不需要填入的,否则会导致连接失败。
5. 保存设置后,你会看到如下图所示的节点状态:
6. 你需要登录到slave的那台机器上,用浏览器打开jenkins slave的链接,点击Launch。
如果slave上没有java,会自动提示安装java,然后点Launch,会自动下载slave-agent.jnlp,下载后点击打开,javaweb.exe会自动启动它。最后会跳出“Connected”的小弹窗,如下图所示,就代表windows slave连接成功啦。连接期间,此小弹窗不可关闭,关闭代表取消连接。
此时刷新浏览器,就可以看到slave连接正常的界面:
7. 如果你希望这台slave能够自动连接,那么可以把它作为安装成为windows service,那么机器重启后、连接无辜断掉后都可自动启动并保持连接。
步骤6里的小窗口,从菜单中选择"File" > "Install as Windows Service":
确认你的操作,点击"OK", 然后slave agent的小窗口会消失,你可以在控制面板>本地服务里面看到Jenkins slave的服务名:
也有时候会碰到安装成为windows service失败的时候,提示“......Access Denied"。解决方法如下:
1. 以管理员身份运行cmd
2. 转到slave-agent.jnlp下载的路径
3. 打开slave-agent.jnlp,会有弹窗提示用java web打开。
4. Java小窗口提示slave connected。
5. 点击“File”菜单 -> "Install as Service",这下就成功啦。
如果想要以某个账号连接Jenkins:
记得修改之后要重启下服务,就会生效。
另外补充下最近尝试的一台windows的机器作为两个Jenkins的slave来连接的经验分享。
这样的背景是,有些进程或者服务在一个slave的节点里只允许一个Executor跑,如果多个Executor同时跑的话会有冲突。但是如果把这台windows的机器以多个jenkins slave来连,然后同时跑的话就可以避免这个冲突。
windows slave的连接全部按照上面介绍的方法,需要特别注意的一点是:再创建第二个slave节点的时候 Remote root directory一定要配置成跟第一个不一样的目录,否则会导致windows服务安装失败(提示jenkins的服务已经在运行中,无法创建新的服务,大概就是重名了)。碰到这个问题的时候在google上一顿查,都没有类似的经验分享。后来自己尝试手动起windows服务指定一个不一样的服务名,也还是服务创建失败( windows无法启动jenkins 错误1067 进程意外终止)。后来终于找到原来可以通过修改Remote root directory来保证起个新的服务不会导致两个slave服务冲突。
如果按照上述步骤一步一步来,一定可以成功哒!祝好运!