Connect Jenkins Windows slave通过J

虽然很多地方都有教程教你如何在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服务冲突。

如果按照上述步骤一步一步来，一定可以成功哒！祝好运！