jenkins-slave 镜像文档

镜像概述与主要用途

jenkins-slave 镜像为 Jenkins 主节点提供 Swarm 模式的构建从节点（Slave），内置 Docker 环境并确保从节点可直接访问 Docker 服务。
主要用途：作为 Jenkins 分布式构建架构的从节点，承担具体的构建、测试任务，尤其适用于依赖 Docker 环境的 CI/CD 流程（如容器镜像构建、Docker 容器化应用测试等）。

核心功能与特性

• Swarm 动态注册：基于 Jenkins Swarm 机制，支持从节点自动发现并注册到 Jenkins 主节点，无需手动配置节点信息。
• 内置 Docker 环境：镜像预装 Docker 服务，从节点可直接执行 docker build、docker run 等命令，满足容器化构建需求。
• 自定义配置灵活：支持通过环境变量自定义从节点名称、标签、并发任务数等参数，适配不同构建场景。

使用场景与适用范围

• 扩展 Jenkins 构建能力：当 Jenkins 主节点负载过高时，通过添加该从节点分担构建任务，提升整体 CI/CD 效率。
• Docker 依赖型构建任务：需在构建过程中使用 Docker 的场景（如微服务镜像构建、容器化应用测试等）。
• 动态伸缩构建资源：根据构建任务量动态调整从节点数量，适配任务高峰与低谷，优化资源利用率。
• 多环境隔离：通过自定义标签（Labels）区分不同类型从节点，实现多版本、多环境构建任务的隔离执行。

使用方法与配置说明

前置条件

1. Jenkins 主节点已正常运行，并安装 Swarm 插件（Jenkins 插件中心搜索 swarm 安装）。
2. 获取 Jenkins 主节点访问 URL（如 [***]）及具有节点注册权限的用户名/密码。

基本部署命令

通过 docker run 命令启动从节点容器，需指定 Jenkins 主节点信息及认证凭证：

docker run \
  -e JENKINS_USERNAME=jenkins \          # Jenkins 主节点用户名（必填）
  -e JENKINS_PASSWORD=jenkins \          # Jenkins 主节点密码（必填）
  -e JENKINS_MASTER=[***] \ # Jenkins 主节点访问 URL（必填）
  rancher/jenkins-slave

环境变量配置

1. 必填环境变量

2. 可选环境变量

自定义配置示例

示例 1：指定从节点名称与标签

启动一个名称为 build-node-01、标签为 docker linux、并发任务数为 4 的从节点：

docker run \
  -e JENKINS_USERNAME=admin \
  -e JENKINS_PASSWORD=jenkins123 \
  -e JENKINS_MASTER=[***] \
  -e SLAVE_NAME=build-node-01 \
  -e SLAVE_LABELS="docker linux" \
  -e SLAVE_EXECUTORS=4 \
  rancher/jenkins-slave

示例 2：Docker Compose 部署

创建 docker-compose.yml 文件，定义从节点服务：

version: '3'
services:
  jenkins-slave:
    image: rancher/jenkins-slave
    environment:
      - JENKINS_USERNAME=admin
      - JENKINS_PASSWORD=jenkins123
      - JENKINS_MASTER=[***]
      - SLAVE_NAME=compose-node
      - SLAVE_LABELS=docker-compose
      - SLAVE_EXECUTORS=2
    restart: unless-stopped

启动服务：

docker-compose up -d

注意事项

• 确保 Jenkins 主节点与从节点网络互通，从节点需能访问主节点的 8080 端口（或主节点实际监听端口）。
• 若从节点需访问宿主机 Docker 服务，可通过挂载宿主机 Docker 套接字实现：

  docker run -v /var/run/docker.sock:/var/run/docker.sock ... rancher/jenkins-slave
  

• 生产环境中建议使用 Jenkins API Token 替代密码认证，提升安全性（将 JENKINS_PASSWORD 替换为 API Token）。