vfarcic/jenkins-swarm-agent

Jenkins Swarm Agent镜像说明

镜像概述

本镜像基于Jenkins Swarm插件构建，是Jenkins集群的代理节点组件，用于连接Jenkins主节点并执行分布式构建任务，帮助扩展集群的构建资源与效率。

核心功能

• 与Jenkins主节点建立安全连接，接收并执行构建任务
• 支持通过COMMAND_OPTIONS环境变量配置Swarm客户端参数
• 提供环境变量和Docker secrets两种认证方式，保障敏感信息安全

使用场景

• Jenkins集群需要快速扩展构建节点时的场景
• 分布式构建任务的执行，提升大型项目的构建效率
• 对认证信息有安全存储需求的Jenkins部署环境

配置说明

1. 必填环境变量：COMMAND_OPTIONS，需填写Swarm客户端参数（参考Swarm Plugin文档获取所有可用参数）。
2. 认证配置：
   • 环境变量方式：通过JENKINS_USER和JENKINS_PASS传递用户名密码
   • Docker secrets方式：将认证信息存储为secrets，通过文件读取使用

部署示例

Docker Run命令

bash
docker run -d \
  -e COMMAND_OPTIONS="-master http://jenkins-master:8080 -username admin -password your_password" \
  vfarcic/jenkins-swarm-agent

Docker Compose（环境变量认证）

yaml
version: '3'
services:
  swarm-agent:
    image: vfarcic/jenkins-swarm-agent
    environment:
      - COMMAND_OPTIONS="-master http://jenkins-master:8080 -username ${JENKINS_USER} -password ${JENKINS_PASS}"

Docker Compose（Docker secrets认证）

yaml
version: '3.7'
services:
  swarm-agent:
    image: vfarcic/jenkins-swarm-agent
    environment:
      - COMMAND_OPTIONS="-master [***] -username $(cat /run/secrets/jenkins_user) -password $(cat /run/secrets/jenkins_pass)"
    secrets:
      - jenkins_user
      - jenkins_pass
secrets:
  jenkins_user:
    file: ./jenkins_user.txt
  jenkins_pass:
    file: ./jenkins_pass.txt