linuxserver/jenkins-builder 镜像文档

镜像概述

linuxserver/jenkins-builder 是由 LinuxServer.io 开发的 Docker 镜像，专为 LSIO (LinuxServer.io) CI (持续集成) 流程设计。该镜像主要用于生成和管理 CI/CD 相关配置文件，不供公众常规使用，仅作为 LSIO 内部 CI 流程的组成部分。

核心功能与特性

• CI/CD 文件生成：自动生成项目所需的 CI/CD 配置文件，包括 README.md、Jenkinsfile、issue 模板等
• 双模式运行：支持针对远程项目和本地项目两种运行模式
• 本地开发支持：允许开发者基于源码构建镜像，进行本地化修改和功能定制
• 多架构兼容：支持在 x86_64 硬件上通过 QEMU 构建 ARM 架构变体

使用场景与适用范围

• LSIO CI 流程集成：作为 LSIO 内部 CI 流水线的关键组件，自动化生成项目配置
• 本地项目测试：开发者在本地验证 CI/CD 配置文件生成逻辑，测试配置效果
• 镜像本地化开发：对镜像功能进行定制或扩展时，通过源码构建进行本地开发

使用方法与配置说明

1. 针对远程项目运行

通过指定远程项目的容器名称和分支，生成对应配置文件：

TEMPDIR=$(mktemp -d) && \
docker run --rm \
  -e CONTAINER_NAME=<容器名称> \
  -e GITHUB_BRANCH=<分支名称> \
  -v ${TEMPDIR}:/ansible/jenkins \
  lscr.io/linuxserver/jenkins-builder:latest

参数说明：

• CONTAINER_NAME：远程项目的容器名称（必填）
• GITHUB_BRANCH：远程项目的目标分支名称（必填）
• TEMPDIR：临时目录，用于存储生成过程中的临时文件

2. 针对本地项目运行

在包含 jenkins-vars.yml 文件的项目目录中，可本地测试配置文件生成功能：

docker pull lscr.io/linuxserver/jenkins-builder:latest && \
docker run --rm \
  -v $(pwd):/tmp \
  -e LOCAL=true \
  -e PUID=$(id -u) -e PGID=$(id -g) \
  lscr.io/linuxserver/jenkins-builder:latest && \
rm -rf .jenkins-external

注意事项：

• 生成的新文件（如 README.md、Jenkinsfile 等）将覆盖当前工作目录中的现有文件
• LOCAL=true：启用本地模式（必填）
• PUID/PGID：当前用户的 UID 和 GID，确保生成文件的权限正确（建议使用 $(id -u) 和 $(id -g) 自动获取）

3. 本地构建镜像

如需对镜像进行本地化修改或开发：

基础构建步骤：

git clone [***]
cd docker-jenkins-builder
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/jenkins-builder:latest .

ARM 架构变体构建：

在 x86_64 硬件上构建 ARM 变体需先注册 QEMU 模拟器：

# 注册 QEMU 多架构支持
docker run --rm --privileged multiarch/qemu-user-static:register --reset

# 构建 ARM 64 位变体（示例）
docker build \
  --no-cache \
  --pull \
  -f Dockerfile.aarch64 \
  -t lscr.io/linuxserver/jenkins-builder:aarch64 .

配置参数

环境变量

版本信息

镜像版本记录通过源码仓库的更新日志维护，主要用于 LSIO 内部流程的循环测试。典型版本记录格式包含日期和更新说明，例如：

• { date: "01.01.50:", desc: "I am the release message for this internal repo." }（仅为测试示例）