当前位置：首页 > article >正文

Jenkins 创建 Node 到 Windows

article 2026/4/8 19:44:20

Jenkins 创建 Node 到 Windows

一. 新建 Node

Dashboard -> Manage Jenkins -> Manage Nodes and Clouds
在这里插入图片描述
Dashboard -> Nodes -> New Node

二. 配置节点

在这里插入图片描述

Node：节点名
Description：节点描述
Number of executors：节点最大同时执行任务数量
Remote root directory：节点代理机器上保存 Jenkins 启动文件的目录，最好使用绝对路径
Labels：节点标签，可以是多个，中间以空格分隔
Usage：控制何时构建时使用这个 Node，这里选择的 Only build jobs with label expressions matching this node：构建时只有当任务Label 选择为此节点中包含的 Label 时，才会执行这个节点
Launch method ：启动方法，这里选择了 Launch agents via SSH 通过 SSH 启动
Host：真正运行Node 的电脑的 ip
Credentials：凭证，上面选择了 Launch agents via SSH，这里需要选择一个 SSH 的凭证
Jenkins 配置 Credentials 凭证
Host Key Verfication Strategy：控制Jenkins在连接时如何验证远程主机提供的SSH密钥
Availability：控制Jenkins何时启动和停止此代理，此处选择了 Keep this agent online as much as possible：尽可能让这个代理保持在线状态
Tool Locations：用到的工具在 Windows 电脑上的路径
上面配置了 git，如果不配置，默认使用的是启动 Jenkins电脑系统上配置的 git，会报错

最后点击 Save 保存

三. 创建如下

在这里插入图片描述
此时节点 WinTest 图标上标记一个红色 X，说明这个节点还未启动
点击 WinTest 节点名，打开节点
Status：节点状态，此时节点未启动
Deleta Agent：删除节点
Configure：节点配置，点击打开回到 二. 配置节点

四.配置 SSH 服务

回到第二步看 Host 填写的 ip 这个是真正运行 Node 的 Windows 电脑的 ip
Jenkins 是在 Mac 电脑上运行，Node 配置中Launch method ：启动方法，选择了 Launch agents via SSH

到 Windows 电脑 Windows 配置 SSH 服务
Mac 电脑上的公钥配置到 Windows 电脑中，具体位置在 Windows 配置 SSH 服务找

测试 Mac 通过 SSH 连接 Windows 电脑，如果能成功连接，到 第五步. 启动节点
注意：Jenkins 中创建的 SSH 凭证中填写的 UserName 需要配置为 Windows电脑的登录用户名，否则验证失败

五. 启动节点

在这里插入图片描述
到 Status 页签，点击 Launch agent

下面几种报错原因以及解决方案
1.

Connection refused (Connection refused)
SSH Connection failed with IOException: "Connection refused (Connection refused)", retrying in 15 seconds. There are 7 more retries left.
Connection refused (Connection refused)

原因：代理机器系统是 Win10，代理机器上还没有启动 SSH 服务
Windows 启动 SSH 服务
再次执行 Launch Agent

Warning: no key algorithms provided; JENKINS-42959 disabled
SSHLauncher{host='10.0.40.182', port=22, credentialsId='liqiangWin', jvmOptions='', javaPath='', prefixStartSlaveCmd='', suffixStartSlaveCmd='', launchTimeoutSeconds=60, maxNumRetries=10, retryWaitTime=15, sshHostKeyVerificationStrategy=hudson.plugins.sshslaves.verifiers.KnownHostsFileKeyVerificationStrategy, tcpNoDelay=true, trackCredentials=true}
[02/18/25 21:20:44] [SSH] Opening SSH connection to 10.0.40.182:22.
Searching for 10.0.40.182 in /Users/townest/.ssh/known_hosts
Searching for 10.0.40.182:22 in /Users/townest/.ssh/known_hosts
[02/18/25 21:20:44] [SSH] WARNING: No entry currently exists in the Known Hosts file for this host. Connections will be denied until this new host and its associated key is added to the Known Hosts file.
Key exchange was not finished, connection is closed.
SSH Connection failed with IOException: "Key exchange was not finished, connection is closed.", retrying in 15 seconds. There are 10 more retries left.
Searching for 10.0.40.182 in /Users/townest/.ssh/known_hosts
Searching for 10.0.40.182:22 in /Users/townest/.ssh/known_hosts
[02/18/25 21:20:59] [SSH] WARNING: No entry currently exists in the Known Hosts file for this host. Connections will be denied until this new host and its associated key is added to the Known Hosts file.
Key exchange was not finished, connection is closed.

报错提示连接的 SSH 主机的身份没有经过验证，可能存在中间人攻击的风险。
为了确保安全，SSH 客户端需要验证连接的服务器的身份，以防止被伪装或受到中间人攻击

回到第二步 Host Key Verfication Strategy：Known hosts file Verification Strategy
主机密钥验证策略配置的为从 Known 文件验证
可以到 Mac 电脑上到 ~/.ssh 路径，可以看到一个 known_hosts 文件，这里边存放了需要访问的电脑的 ip
打开会看到每行以一个 ip 地址开头，后跟 ssh 公钥
比如上面启动 SSH 服务的 Windows 电脑 ip 为 10.0.40.182
解决方案有多种，这里只处理一种

# ssh-keyscan -H hostname >> ~/.ssh/known_hosts
# hostname 就是启动 SSH 服务电脑的 IP
ssh-keyscan -H 10.0.40.182 >> ~/.ssh/known_hosts

这个命令会获取主机10.0.40.182的公钥并将其追加到 ~/.ssh/known_hosts 文件中

SSHLauncher{host='10.0.40.182', port=22, credentialsId='liqiangWin', jvmOptions='', javaPath='', prefixStartSlaveCmd='', suffixStartSlaveCmd='', launchTimeoutSeconds=60, maxNumRetries=10, retryWaitTime=15, sshHostKeyVerificationStrategy=hudson.plugins.sshslaves.verifiers.NonVerifyingKeyVerificationStrategy, tcpNoDelay=true, trackCredentials=true}
[02/19/25 11:27:27] [SSH] Opening SSH connection to 10.0.40.182:22.
[02/19/25 11:27:27] [SSH] WARNING: SSH Host Keys are not being verified. Man-in-the-middle attacks may be possible against this connection.
ERROR: Server rejected the 1 private key(s) for xxxxx (credentialId:Win/method:publickey)
[02/19/25 11:27:27] [SSH] 认证失败。
认证失败。
[02/19/25 11:27:27] Launch failed - cleaning up connection
[02/19/25 11:27:27] [SSH] 连接关闭。

SSH 服务器上配置了 Mac 电脑的公钥，不了解的看这里 Windows 配置 SSH 服务
上面这个报错是 SSH服务器通过 Mac 的公钥验证 Mac 电脑的私钥失败

ERROR: Server rejected the 1 private key(s) for xxxxx (credentialId:Win/method:publickey)

看上面报错日志中的 for xxxxx 这个 xxxxx 是导致验证失败的原因
这是因为我在Jenkins 中配置 SSH密钥凭证的时候 UserName 没有写成开启 SSH 服务的 Windows 电脑的登录账号名
回到 SSH 密钥凭证，修改密钥凭证的 UserName为 SSH 服务的 Windows 电脑的登录账号名

[SSH] Starting agent process: cd "F:\Jenkins" && E:\JDK12/bin/java  -jar remoting.jar -workDir D:\jenkins_ws -jar-cache D:\jenkins_ws/remoting/jarCache
Error: Unable to access jarfile remoting.jar
Agent JVM has terminated. Exit code=1

上面报错原因是通过 JDK 启动 jenkins 的时候没有对 remoting.jar 的权限
(1) remoting.jar 文件的作用：我们这里是 Mac 电脑上配置的 Jenkins 添加一个 Node 到 Windows 电脑上，那么Windows 电脑需要从 Mac 电脑的 Jenkins 中下载一个 remoting.jar 有的是 agent.jar 到 Windows 电脑上，然后通过 JDK命令执行这个 remoting.jar 或者 agent.jar，启动Jenkins 在 Windows 电脑上运行

(2) 对于命令中的几个路径从哪里来的做个解释

cd "F:\Jenkins" && E:\JDK12/bin/java  -jar remoting.jar -workDir D:\jenkins_ws -jar-cache D:\jenkins_ws/remoting/jarCache

先到 Node 配置界面
Remote root directory 配置为 F:\Jenkins
Remoting Work directory 配置为 D:\jenkins_ws
在这里插入图片描述
这个命令是一个组合命令
先执行 cd "F:\Jenkins" 切换路径
在执行 E:\JDK12/bin/java -jar remoting.jar -workDir D:\jenkins_ws -jar-cache D:\jenkins_ws/remoting/jarCache
Jenkins 执行通过 SSH 连接到 SSH 服务的时候其实是在路径 C:\Users\Administrator>
remoting.jar 文件是被 Jenkins 放到路径 F:\Jenkins，所以要先 cd 到这个路径

Error: Unable to access jarfile remoting.jar 纯属是个人 Windows 系统 cmd 环境不同导致的报错
经过测试发现有的电脑 cmd 不管当前在哪个盘符
执行 cd "F:\Jenkins" && E:\JDK12/bin/java -jar remoting.jar -workDir D:\jenkins_ws -jar-cache D:\jenkins_ws/remoting/jarCache 就是成功的

我的电脑上如果 cmd 当前盘符不是 F盘那么就会报这个错
修改命令在 cd 后边加上 /d

cd /d "F:\Jenkins" && E:\JDK12/bin/java  -jar remoting.jar -workDir D:\jenkins_ws -jar-cache D:\jenkins_ws/remoting/jarCache

执行发现可以执行成功
解释：在命令行中使用 /d 参数的作用是允许跨磁盘驱动器切换目录
如果不加 /d 参数，cd 命令通常只能在同一磁盘驱动器内切换目录
例如
如果当前目录在 C 盘，使用 cd 命令切换到 C 盘的其他目录是可以正常工作的
但如果要切换到 D 盘的某个目录则会失败
而加上 /d 参数后，就可以跨磁盘驱动器切换目录，例如从 C 盘切换到 D 盘的某个目录‌

因为这个命令行是 Jenkins 拼接的，我没找到在哪里配置的，所以我没法加 /d
我的修改方案是，Remote root directory：C:\Jenkins
直接修改到 C盘

再次重新 Launch agent

[SSH] Starting agent process: cd "C:\Jenkins" && E:\JDK12/bin/java  -jar remoting.jar -workDir D:\jenkins_ws -jar-cache D:\jenkins_ws/remoting/jarCache
org.jenkinsci.remoting.engine.WorkDirManager initializeWorkDir
: Using D:\jenkins_ws\remoting as a remoting work directory
rg.jenkinsci.remoting.engine.WorkDirManager setupLogging
Both error and output logs will be printed to D:\jenkins_ws\remoting
<===[JENKINS REMOTING CAPACITY]===>channel started
Remoting version: 4.10

上面日志显示节点启动成功

[02/21/25 14:14:07] [SSH] Starting agent process: cd "C:\Jenkins_2" && java  -jar remoting.jar -workDir C:\Jenkins_2 -jar-cache C:\Jenkins_2/remoting/jarCache
2�� 21, 2025 2:14:07 ���� org.jenkinsci.remoting.engine.WorkDirManager initializeWorkDir
��Ϣ: Using C:\Jenkins_2\remoting as a remoting work directory
2�� 21, 2025 2:14:07 ���� org.jenkinsci.remoting.engine.WorkDirManager setupLogging
��Ϣ: Both error and output logs will be printed to C:\Jenkins_2\remoting
<===[JENKINS REMOTING CAPACITY]===>channel started
2�� 21, 2025 2:14:07 ���� hudson.remoting.UserRequest perform
����: LinkageError while performing UserRequest:hudson.slaves.SlaveComputer$SlaveVersion@455044b3
java.lang.UnsupportedClassVersionError: Failed to load hudson.slaves.SlaveComputer$SlaveVersionat hudson.remoting.RemoteClassLoader.loadClassFile(RemoteClassLoader.java:472)at hudson.remoting.RemoteClassLoader.loadRemoteClass(RemoteClassLoader.java:301)at hudson.remoting.RemoteClassLoader.loadWithMultiClassLoader(RemoteClassLoader.java:277)at hudson.remoting.RemoteClassLoader.findClass(RemoteClassLoader.java:236)at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:588)at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:521)at java.base/java.lang.Class.forName0(Native Method)at java.base/java.lang.Class.forName(Class.java:398)at hudson.remoting.MultiClassLoaderSerializer$Input.resolveClass(MultiClassLoaderSerializer.java:133)at java.base/java.io.ObjectInputStream.readNonProxyDesc(ObjectInputStream.java:1886)at java.base/java.io.ObjectInputStream.readClassDesc(ObjectInputStream.java:1772)at java.base/java.io.ObjectInputStream.readOrdinaryObject(ObjectInputStream.java:2060)at java.base/java.io.ObjectInputStream.readObject0(ObjectInputStream.java:1594)at java.base/java.io.ObjectInputStream.readObject(ObjectInputStream.java:430)at hudson.remoting.UserRequest.deserialize(UserRequest.java:312)at hudson.remoting.UserRequest.perform(UserRequest.java:196)at hudson.remoting.UserRequest.perform(UserRequest.java:50)at hudson.remoting.Request$2.run(Request.java:391)at hudson.remoting.InterceptingExecutorService.lambda$wrap$0(InterceptingExecutorService.java:81)at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:264)at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128)at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628)at java.base/java.lang.Thread.run(Thread.java:834)
Caused by: java.lang.UnsupportedClassVersionError: hudson/slaves/SlaveComputer$SlaveVersion has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 55.0at java.base/java.lang.ClassLoader.defineClass1(Native Method)at java.base/java.lang.ClassLoader.defineClass(ClassLoader.java:1016)at java.base/java.lang.ClassLoader.defineClass(ClassLoader.java:877)at hudson.remoting.RemoteClassLoader.loadClassFile(RemoteClassLoader.java:470)... 22 moreAgent JVM has not reported exit code. Is it still running?
[02/21/25 14:14:10] Launch failed - cleaning up connection
[02/21/25 14:14:10] [SSH] Connection closed.
ERROR: Connection terminated

上面日志 cd "C:\Jenkins_2" && java -jar remoting.jar -workDir C:\Jenkins_2 -jar-cache C:\Jenkins_2/remoting/jarCache 执行已经成功了，下面还有报错
找到日志中

Caused by: java.lang.UnsupportedClassVersionError: hudson/slaves/SlaveComputer$SlaveVersion has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 55.0

这表明当前使用的 Java 运行时只能处理到 class 文件版本 55.0，而 Jenkins 代码则是用 class 文件版本 61.0 编译的
根据 Java 的版本对应关系：
Class file version 61.0 对应 Java 17
Class file version 55.0 对应 Java 11
因此，这个错误的解决方案是确保 Jenkins 节点也就是 Windows 使用 Java 17 或更高版本来运行，安装 JDK17

Jenkins 创建 Node 到 Windows