rodrigorfk/docker-jnlp-slave

Jenkins JNLP代理Docker镜像

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

镜像概述

这是一个用于Jenkins代理（原称“slave”）的镜像，通过JNLP协议与Jenkins服务器建立连接。该代理基于Jenkins Remoting库，版本取自基础的https://github.com/jenkinsci/docker-slave/%E9%95%9C%E5%83%8F%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E5%8F%AF%E5%8F%82%E8%80%83Jenkins%E5%88%86%E5%B8%83%E5%BC%8F%E6%9E%84%E5%BB%BA%E3%80%82

核心功能

1. 通过JNLP协议与Jenkins服务器建立安全连接
2. 支持自定义代理工作目录
3. 可通过环境变量配置Jenkins服务器地址、代理密钥、代理名称等参数
4. 兼容JNLP4-connect协议（推荐Jenkins 2.32.x LTS及以上版本使用）

使用场景

• Jenkins主节点负载较高时，部署该代理分担构建任务
• 在容器化环境（如Docker、Amazon ECS）中快速部署Jenkins代理
• 需要跨网络环境连接Jenkins主节点的场景（通过JENKINS_TUNNEL参数配置）

配置说明

运行命令示例

基础运行

bash
docker run jenkins/jnlp-slave -url http://jenkins服务器地址:端口 <代理密钥> <代理名称>

指定工作目录运行

bash
docker run jenkins/jnlp-slave -url http://jenkins服务器地址:端口 -workDir=/home/jenkins/agent <代理密钥> <代理名称>

可选环境变量

• JENKINS_URL: Jenkins服务器地址，可替代-url参数
• JENKINS_TUNNEL: 代理连接的隧道地址（格式：HOST:PORT），用于Jenkins主节点在负载均衡或反向代理后的场景
• JENKINS_SECRET: 代理密钥，若未通过命令参数传递则使用此变量
• JENKINS_AGENT_NAME: 代理名称，若未通过命令参数传递则使用此变量
• JENKINS_AGENT_WORKDIR: 代理工作目录，若未通过-workDir参数指定则使用此变量

启用JNLP协议

默认情况下，JNLP3-connect协议因稳定性和可扩展性问题被禁用。若需启用，可设置环境变量：

bash
JNLP_PROTOCOL_OPTS=-Dorg.jenkinsci.remoting.engine.JnlpProtocol3.disabled=false

（需同时在Jenkins主节点启用该协议）

Jenkins 2.27及以上版本支持JNLP4-connect协议，推荐Jenkins 2.32.x LTS及以上版本使用该协议。

Amazon ECS部署注意事项

确保ECS容器代理已更新，旧版本可能无法正确处理entryPoint参数。详情参考ECS容器定义文档。