foxylion/jenkins-slave

foxylion/jenkins-slave 镜像说明

镜像概述

foxylion/jenkins-slave是一个灵活的Jenkins JNLP从节点镜像，支持自动临时节点创建（容器停止时自动删除）、Docker流水线操作，以及通过凭据或JNLP密钥进行身份验证。它与Jenkins主节点配合，实现分布式CI/CD构建，提升构建效率和资源利用率。

核心功能

• 节点模式灵活：支持临时节点（自动创建/销毁）和持久节点两种模式。
• 多身份验证方式：可通过JNLP密钥或用户名/密码与Jenkins主节点认证。
• 自定义配置：允许设置从节点名称、执行器数量、标签、工作目录等参数。
• Docker集成：支持挂载Docker套接字，实现Docker-in-Docker的流水线任务。
• 自动清理：默认启动时清理工作目录，避免残留数据导致构建失败。

使用场景

1. 分布式构建：将主节点的构建任务分散到多个从节点，加速构建过程。
2. 临时构建环境：按需创建临时从节点，任务完成后自动销毁，节省资源。
3. 容器化流水线：直接在从节点执行Docker相关任务（如镜像构建、推送）。

配置说明

环境变量

以下环境变量可自定义从节点行为：

部署示例

临时从节点（自动创建/销毁）

bash
docker run -d --name jenkins-slave --restart=unless-stopped \
           -v /home/jenkins:/home/jenkins \
           -v /var/run/docker.sock:/var/run/docker.sock \
           -e JENKINS_URL=https://jenkins.mycompany.com \
           foxylion/jenkins-slave

• 自动生成节点名称（前缀docker-slave+容器主机名）。
• 容器停止时自动删除Jenkins节点。

持久从节点

bash
docker run -d \
           -v /home/jenkins:/home/jenkins \
           -v /var/run/docker.sock:/var/run/docker.sock \
           -e JENKINS_URL=http://jenkins.mycompany.com \
           -e SLAVE_NAME=docker-slave-028 \
           foxylion/jenkins-slave

• 需在Jenkins主节点预先创建名称为docker-slave-028的节点。
• 远程根目录需设置为/home/jenkins。

注意事项

• JNLP通信未加密，建议在可信网络使用；如需加密，可选择SSH模式从节点。
• 挂载Docker套接字时需确保权限安全，避免未授权访问。
• 自定义工作目录时，需同步主机和容器的路径（如-w /tmp/jenkins-slave并挂载对应目录）。