eeacms/jenkins-slave

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

基于Jenkins Swarm Plugin的Jenkins从节点Docker镜像，用于连接Jenkins主节点并执行构建任务。与https://hub.docker.com/r/eeacms/jenkins-master/%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%E6%95%88%E6%9E%9C%E6%9C%80%E4%BD%B3%EF%BC%8C%E4%B9%9F%E5%8F%AF%E7%94%A8%E4%BA%8E%E9%9D%9EEEA%E7%9B%B8%E5%85%B3%E9%A1%B9%E7%9B%AE%E3%80%82

支持的标签及Dockerfile链接

• https://github.com/eea/eea.docker.jenkins.slave/blob/master/Dockerfile
• https://github.com/eea/eea.docker.jenkins.slave/blob/3.49/Dockerfile

查看https://github.com/eea/eea.docker.jenkins.slave/releases

变更记录

• https://github.com/eea/eea.docker.jenkins.slave/blob/master/CHANGELOG.md

基础Docker镜像

• https://registry.hub.docker.com/u/eeacms/jenkins-slave

源代码

• http://github.com/eea/eea.docker.jenkins.slave

核心功能与特性

• 基于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主从节点编排指南参见https://github.com/eea/eea.docker.jenkins%E3%80%82

支持的环境变量

• 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（如http://jenkins-server），指定后跳过自动发现
• 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）