如何将Jenkins从代理重新连接至原机器（无需删除节点）

核心问题解答 #

• 能否不删除代理/节点重新连接到正确机器？
  完全可以！不需要删除已有的节点配置，只需要断开错误机器上的代理连接，然后让正确的机器重新建立JNLP连接即可。

• 删除代理的话，节点会被彻底删除吗？
  这里要区分两种操作：

  • 如果是在Jenkins控制台的「节点管理」页面删除整个节点（Agent），那么该节点的所有配置（标签、执行器数量、环境变量等）会被彻底删除，之后需要重新创建节点。
  • 如果只是在错误机器上停止代理进程，或者在Jenkins控制台点击「断开连接」「终止代理」，那么节点配置会保留，只是状态变为离线，后续可以重新连接。

针对你的具体场景解决办法 #

你提到误在错误机器上通过Launch按钮启动了代理，现在找不到Launch按钮，且执行命令失败，按以下步骤处理：

1. 先断开错误机器的代理连接

当Jenkins检测到节点已有在线代理时，会隐藏Launch按钮。你需要先强制断开错误的连接：

• 登录Jenkins控制台，进入「Manage Jenkins」→「Manage Nodes and Clouds」
• 找到对应的节点，点击进入节点详情页
• 点击页面上的「Disconnect」或「Terminate Agent」按钮（不同Jenkins版本按钮名称可能略有不同），确认断开错误机器的连接

断开后，节点会显示为离线状态，Launch按钮就会重新出现在节点详情页中。

2. 解决java -jar slave.jar命令执行失败的问题

你尝试的命令方向是对的，但执行失败可能有以下几个原因，逐一排查：

• 检查JNLP URL是否正确：
  把命令中的<<build-server:port>>替换为实际的Jenkins服务器地址（比如your-jenkins-server:8080），<<agent name>>替换为节点的准确名称。如果节点名称包含空格或特殊字符，需要进行URL编码（例如空格换成%20）。
  正确的命令示例：

  java -jar slave.jar -jnlpUrl http://jenkins.example.com:8080/computer/My%20Agent/slave-agent.jnlp
  

• 确保目标机器能访问Jenkins服务器：
  在目标机器上ping Jenkins服务器地址，检查网络连通性；同时确认防火墙/安全组没有阻挡Jenkins的端口（默认是8080）。
• 使用对应版本的slave.jar：
  最好从节点详情页的Launch按钮旁边下载最新的slave.jar（断开错误连接后就能看到下载链接），避免版本不兼容导致的问题。
• 检查Java版本兼容性：
  Jenkins代理对Java版本有要求（比如Jenkins 2.309及以上需要Java 11+），在目标机器上执行java -version确认版本符合要求，若不符合则升级Java。
• 确认执行权限：
  确保执行命令的用户有读写C:\Jenkins目录的权限，以及访问Jenkins JNLP URL的权限。

内容的提问来源于stack exchange，提问作者juLeZ90