跳过正文
Background Image
  1. Posts/

Jenkins Windows Agent 配置

·608 字·2 分钟· ·
沈显鹏
作者
沈显鹏
目录

准备 Java 运行时
#

1. 下载 Java
#


2. 配置 Windows 系统环境变量
#

JAVA_HOME=C:\Program Files\Java\jdk1.8.0_201
CLASSPATH=.;%JAVA_HOME%\lib;%JAVA_HOME%\jre\lib

创建节点
#

1. 在 Jenkins 首页进入
#

Manage Node → New Node,例如创建 window-build-machine


2. Windows Agent 设置示例
#

项目配置
Namewindow-build-machine
Description用于 Windows 构建
# of executors1
Remote root directoryC:\agent
Labelswindows, build
Usage尽可能多地使用此节点
Launch method让 Jenkins 以 Windows 服务的方式控制此 Agent
Administrator user name.\Administrator
Passwordmypassword
Host192.168.1.111
Run service as使用上述 Administrator 账户
Availability尽可能保持此 Agent 在线

3. 保存并连接
#

[windows-slaves] Connecting to 192.168.1.111
Checking if Java exists
java -version returned 1.8.0.
[windows-slaves] Copying jenkins-slave.xml
[windows-slaves] Copying slave.jar
[windows-slaves] Starting the service
[windows-slaves] Waiting for the service to become ready
<===[JENKINS REMOTING CAPACITY]===>Remoting version: 3.29
This is a Windows agent
Agent successfully connected and online

常见问题排查
#

1. ERROR: Message not found for errorCode: 0xC00000AC
#

需要安装 JDK,并配置 JAVA 环境变量。


2. 添加 Windows 节点作为服务时报错
#

参考 JENKINS-16418


3. org.jinterop.dcom.common.JIException: Message not found for errorCode: 0x00000005
#

修复以下注册表项权限:

  1. HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Wow6432Node\CLSID{72C24DD5-D70A-438B-8A42-98424B88AFB8}
  2. HKEY_CLASSES_ROOT\CLSID{76A64158-CB41-11D1-8B02-00600806D9B6}

步骤:

  • 打开 regedit(以管理员身份),找到对应注册表项
  • 修改所有者为 Administrators 组,并赋予 完全控制 权限
  • 将所有者改回 NT Service\TrustedInstaller
  • 重启 Remote Registry Service

4. ERROR: Unexpected error in launching an agent
#

  1. 登录远程机器,在服务中找到 jenkinsslave-C__agent
  2. 启动类型设为 Automatic
  3. Log On 选择 This account 并输入正确账号密码
  4. 启动服务

5. errorCode: 0x800703FA
#

Agent 使用域账号运行时,在组策略中:

  • 打开 gpedit.msc
  • 计算机配置 → 管理模板 → 系统 → 用户配置文件
  • 启用 Do not forcefully unload the user registry at user logoff

6. errorCode: 0xC0000001 ... Failed to connect
#

需要启用 SMB1:

  1. 打开 启用或关闭 Windows 功能
  2. 勾选 SMB 1.0/CIFS File Sharing Support
  3. 确认并重启

7. .NET Framework 2.0 or later is required
#

升级 .NET Framework,参考 这篇文章


8. 更多 Windows Agent 连接问题
#

参考:https://github.com/jenkinsci/windows-slaves-plugin/blob/master/docs/troubleshooting.adoc

相关文章

Jenkins Linux Agent 配置
·353 字·1 分钟
本文提供了 Jenkins Linux Agent 的逐步配置指南,包括 Java 运行时的准备、节点创建以及常见问题的排查方法。
Jenkinsfile 配置
·256 字·1 分钟
本文介绍了如何使用 Jenkinsfile 配置 Jenkins Pipeline,包括构建、测试和发布阶段的示例,以及如何处理邮件通知。