Jenkins从节点Docker镜像（基于Jenkins Swarm Plugin）

基于Jenkins Swarm Plugin的Jenkins从节点Docker镜像，用于连接Jenkins主节点并执行构建任务。与eeacms/jenkins-master配合使用效果最佳，也可用于非EEA相关项目。

支持的标签及Dockerfile链接

• :latest （Dockerfile）
• :3.49（Dockerfile）

查看旧版本

变更记录

• CHANGELOG.md

基础Docker镜像

• hub.docker.com

源代码

• github.com

核心功能与特性

• 基于Jenkins Swarm Plugin实现从节点自动注册与连接
• 支持通过命令行参数或环境变量配置认证信息（用户名/密码）
• 可自定义JVM参数（如堆内存设置、系统属性）
• 支持配置从节点名称、描述、标签及执行器数量
• 支持隧道连接和SSL验证禁用，适应复杂网络环境
• 可通过Dockerfile扩展系统依赖，满足项目特定需求

适用场景

适用于Jenkins分布式构建环境，需多个从节点并行执行构建任务的CI/CD场景，尤其适合需要扩展构建能力、实现任务隔离的自动化流程。

安装

1. 安装Docker。
2. 安装Docker Compose。

使用方法

基本使用

bash
$ docker run eeacms/jenkins-slave

高级使用

通过命令行参数指定用户名和密码连接主节点：

bash
$ docker run eeacms/jenkins-slave -username foo -password secret

或通过环境变量配置：

bash
$ docker run -e JENKINS_USER=foo -e JENKINS_PASS=secret eeacms/jenkins-slave

查看所有可用选项：

bash
$ docker run --rm eeacms/jenkins-slave --help

完整的Jenkins主从节点编排指南参见EEA Jenkins master-slave orchestration。

支持的环境变量

• JENKINS_USER：连接主节点的Jenkins用户名，需具备从节点管理权限
• JENKINS_PASS：Jenkins用户密码
• JENKINS_PASS_ENV：含特殊字符的密码（替代JENKINS_PASS使用）
• JAVA_OPTS：JVM参数配置，如-Xmx512m -Dproperty=value
• JENKINS_NAME：从节点名称
• JENKINS_DESCRIPTION：从节点描述信息
• JENKINS_EXECUTORS：执行器数量，默认等于CPU核心数
• JENKINS_LABELS：空格分隔的标签列表，用于任务分配
• JENKINS_RETRY：连接失败重试次数（未指定则无限重试）
• JENKINS_MODE：任务分配模式，normal（优先利用）或exclusive（仅绑定任务），默认normal
• JENKINS_MASTER：主节点完整URL（如[***]），指定后跳过自动发现
• JENKINS_TUNNEL：隧道连接地址（格式HOST:PORT），用于间接连接主节点
• JENKINS_TOOL_LOCATIONS：工具路径配置（格式toolName:location，空格分隔多工具）
• JENKINS_NO_RETRY_AFTER_CONNECTED：成功连接后断开不重试
• JENKINS_AUTO_DISCOVERY_ADDRESS：UDP自动发现地址，默认255.255.255.255
• JENKINS_DISABLE_SSL_VERIFICATION：禁用SSL验证
• JENKINS_OPTS：批量参数传递，如-e JENKINS_OPTS="-labels code -executors 2"

扩展镜像

当预装系统库不足时，可基于此镜像构建自定义从节点：

Dockerfile示例

dockerfile
FROM eeacms/jenkins-slave

USER root
RUN apt-get update \
 && apt-get install -y --no-install-recommends \
    # 添加所需系统依赖，如git、maven等
    git \
    maven \
 && rm -rf /var/lib/apt/lists/*
USER jenkins

构建自定义镜像：

bash
$ docker build -t jenkins-slave-custom .

故障排除

从节点连接失败时：

1. 直接指定主节点URL：-e JENKINS_MASTER=http://<主节点IP或域名>
2. 登录主节点http://<主节点IP>/configure，确认"Jenkins URL"配置正确
3. 检查从节点网络是否能访问主节点端口，重启从节点容器

版权与许可

原始代码的初始所有者为欧洲环境署（EEA）。保留所有权利。

原始代码为自由软件，可根据GNU通用公共许可证（GPL）第2版或更高版本的条款重新分发和/或修改。

资助方

欧洲环境署（EU）