jenkinsci/jnlp-slave

Jenkins JNLP Agent Docker镜像

![Gitter聊天]([***]

⚠️ 警告！ 此镜像曾以 https://hub.docker.com/r/jenkinsci/jnlp-slave/ 发布。该镜像名称已弃用，请使用 https://hub.docker.com/r/jenkins/jnlp-slave/%E3%80%82

镜像概述和主要用途

这是用于 Jenkins 代理（曾称“slave”）的Docker镜像，通过JNLP（Java Network Launch Protocol）协议与Jenkins服务器建立连接。此代理基于 https://github.com/jenkinsci/remoting 实现，其版本取自基础 https://github.com/jenkinsci/docker-slave/ 镜像。

有关Jenkins分布式构建的更多信息，请参见 Jenkins分布式构建文档。

核心功能和特性

• 通过JNLP协议实现Jenkins服务器与代理的安全连接
• 支持Linux和Windows两种操作系统环境
• 内置Jenkins Remoting库，确保与Jenkins服务器的兼容性
• 支持工作目录配置，隔离构建环境
• 提供环境变量配置，简化代理部署流程
• 支持WebSocket连接方式，适应复杂网络环境（如负载均衡、反向代理场景）

使用场景和适用范围

• Jenkins分布式构建环境，需要将构建任务分发到多台代理节点
• 容器化部署Jenkins代理，简化环境一致性管理
• 需要通过JNLP协议绕过网络限制连接Jenkins服务器的场景
• 支持Linux和Windows混合构建环境的需求

使用方法和配置说明

基本运行命令

Linux代理

bash
docker run --init jenkins/jnlp-slave -url http://jenkins-server:port <secret> <agent name>

注意：--init 参数对于正确处理子进程（僵尸进程回收）是必需的。

Windows代理

bash
docker run jenkins/jnlp-agent:latest-windows -Url http://jenkins-server:port -Secret <secret> -Name <agent name>

指定工作目录运行

Linux代理

bash
docker run --init jenkins/jnlp-slave -url http://jenkins-server:port -workDir=/home/jenkins/agent <secret> <agent name>

Windows代理

bash
docker run jenkins/jnlp-agent-windows -Url http://jenkins-server:port -WorkDir=C:/Jenkins/agent -Secret <secret> -Name <agent name>

环境变量配置

以下环境变量可用于配置代理行为，作为命令行参数的替代方案：

配置细节

支持的JNLP协议

从3.40-1版本开始，此镜像仅支持 https://github.com/jenkinsci/remoting/blob/master/docs/protocols.md#jnlp4-connect 协议。早期的长期未支持协议已被移除，因此不再支持2.32之前的Jenkins版本。

Amazon ECS部署注意事项

在Amazon ECS上运行时，确保ECS容器代理已 更新。旧版本的ECS代理无法正确处理entryPoint参数。有关更多信息，请参见 ECS容器定义中的entryPoint说明。