vipconsult/jenkins-swarm-agent

vipconsult/jenkins-swarm-agent镜像说明

镜像概述

vipconsult/jenkins-swarm-agent是运行Jenkins Swarm插件的轻量镜像，通过Docker secret传递连接参数，自动连接到指定Jenkins master，提供分布式CI/CD任务执行能力。

核心功能

1. 通过Swarm插件实现与Jenkins master的自动连接
2. 支持Docker secret安全存储连接凭证（master地址、账号密码）
3. 可配置节点标签、执行器数量及数据目录
4. 挂载Docker socket实现容器内直接操作主机Docker服务（替代Docker-in-Docker方案）
5. Docker Swarm全局模式部署，新增节点自动加入slave集群

使用场景

适用于测试、staging、生产环境的Docker Swarm集群，为Jenkins提供弹性扩展的slave节点资源，执行流水线任务。

配置说明

前提条件

主机需运行Docker daemon，并创建包含Jenkins连接参数的secret：

bash
echo "-master http://10.0.0.101 -password admin -username admin" | docker secret create jenkins-v1 -

• 替换10.0.0.101为实际Jenkins master IP
• jenkins-v1名称便于后续密码轮换（参考https://docs.docker.com/engine/swarm/secrets/#example-rotate-a-secret）

环境变量配置

部署示例

测试环境Swarm部署

bash
docker service create \
    --mode=global \
    --name jenkins-swarm-agent \
    -e LABELS=docker-test \
    --mount "type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock" \
    --mount "type=bind,source=/tmp/,target=/tmp/" \
    --secret source=jenkins-v1,target=jenkins \
    vipconsult/jenkins-swarm-agent

Staging环境Swarm部署

bash
docker service create \
    --mode=global \
    --name jenkins-swarm-agent \
   -e LABELS=docker-stage \
    --mount "type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock" \
    --mount "type=bind,source=/tmp/,target=/tmp/" \
    --secret source=jenkins-v1,target=jenkins \
    vipconsult/jenkins-swarm-agent  

生产环境Swarm部署

bash
docker service create \
    --mode=global \
    --name jenkins-swarm-agent \
    -e LABELS=docker-prod \
    --mount "type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock" \
    --mount "type=bind,source=/tmp/,target=/tmp/" \  
    --secret source=jenkins-v1,target=jenkins \
    vipconsult/jenkins-swarm-agent  

部署参数说明

• --mode=global：集群新增节点自动部署agent
• Docker socket挂载：允许容器内操作主机Docker服务
• tmp目录挂载：共享任务生成文件
• secret使用：安全传递Jenkins连接凭证
• LABELS设置：匹配Jenkinsfile中的节点标签（如node("docker-test")）