t4skforce/jenkins-slave

jenkins-slave 镜像文档

镜像概述

jenkins-slave 是一个基于官方 jenkinsci/slave 镜像构建的完全更新版本，作为 Jenkins 持续集成/持续部署（CI/CD）系统的从节点（Slave）。该镜像旨在与 Jenkins 主节点配合工作，承担具体的构建、测试和部署任务，扩展 Jenkins 系统的处理能力。

核心功能与特性

• 基于官方镜像：以 jenkinsci/slave 为基础，确保与 Jenkins 生态系统的兼容性
• 完全更新：包含最新的系统依赖、安全补丁和工具链，减少潜在漏洞
• 轻量级设计：保持精简的镜像体积，同时提供基础构建所需的核心组件
• 灵活扩展：支持根据需求添加自定义工具和环境依赖

使用场景与适用范围

• CI/CD 流水线扩展：为 Jenkins 主节点分担构建压力，支持多任务并行执行
• 多环境构建：可作为专用从节点适配不同编程语言（如 Java、Python、Node.js 等）或构建工具（如 Maven、Gradle、npm 等）的任务
• 企业级自动化：适用于需要稳定、高效执行自动化构建任务的团队或组织

使用方法与配置说明

前置条件

• 已部署 Jenkins 主节点，并获取从节点连接所需的 URL 和密钥（通过 Jenkins 主节点的“管理节点”功能生成）
• 安装 Docker 环境

基本使用（Docker Run）

通过以下命令启动 Jenkins 从节点，连接至指定的 Jenkins 主节点：

bash
docker run -d \
  --name docker.xuanyuan.run/jenkins-slave \
  -e JENKINS_URL=<Jenkins主节点URL> \
  -e JENKINS_SECRET=<从节点连接密钥> \
  -e JENKINS_AGENT_NAME=<从节点名称> \
  docker.xuanyuan.run/jenkins-slave

参数说明：

• JENKINS_URL：Jenkins 主节点的访问地址（如 http://jenkins-master:8080）
• JENKINS_SECRET：从节点与主节点通信的密钥（从 Jenkins 主节点获取）
• JENKINS_AGENT_NAME：从节点在 Jenkins 主节点中显示的名称（可选，默认自动生成）

Docker Compose 配置示例

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

yaml
version: '3'
services:
  jenkins-slave:
    image: docker.xuanyuan.run/jenkins-slave
    container_name: jenkins-slave
    environment:
      - JENKINS_URL=http://jenkins-master:8080
      - JENKINS_SECRET=your-slave-secret-key
      - JENKINS_AGENT_NAME=my-slave-node
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

自定义配置

如需添加额外工具或依赖，可基于该镜像构建自定义镜像，例如：

dockerfile
FROM docker.xuanyuan.run/jenkins-slave

# 安装额外工具（示例：安装Maven）
RUN apt-get update && apt-get install -y maven && rm -rf /var/lib/apt/lists/*

构建并使用自定义镜像：

bash
docker build -t my-custom-jenkins-slave .
docker run -d --name my-slave -e JENKINS_URL=... -e JENKINS_SECRET=... docker.xuanyuan.run/my-custom-jenkins-slave

注意事项

• 确保 Jenkins 主节点与从节点之间网络通畅，从节点可访问主节点的 URL
• 定期更新镜像以获取最新的安全补丁和功能改进
• 根据实际构建任务需求调整从节点的资源配置（如 CPU、内存限制）