Debian 上 Jenkins 的版本控制管理实践
一 核心概念与目标
- 对 Jenkins 自身：用 Debian 的 APT 包管理进行版本控制与升级，保证二进制与依赖的一致性与可回滚性。
- 对 Jenkins 配置与任务：将 Job 配置、全局配置、插件清单纳入 Git 版本控制，实现配置即代码、审计与快速恢复。
- 对 业务代码：在 Job 中配置 Git 源码管理（SSH 或 HTTPS），并结合 Webhook/Poll SCM触发构建，形成标准 CI 流程。
二 管理 Jenkins 自身的版本
- 备份关键数据（升级前必做）：配置文件 /var/lib/jenkins/config.xml，任务目录 /var/lib/jenkins/jobs/，插件目录 /var/lib/jenkins/plugins/，以及日志 /var/log/jenkins/jenkins.log。可使用打包或 rsync 做快照。
- 停止服务：sudo systemctl stop jenkins
- 升级方式（推荐 APT）：
- 导入官方 GPG 密钥并添加稳定仓库：
- wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
- echo deb http://pkg.jenkins.io/debian-stable binary/ | sudo tee /etc/apt/sources.list.d/jenkins.list
- 执行升级：sudo apt update && sudo apt install jenkins
- 启动并验证：sudo systemctl start jenkins && sudo systemctl status jenkins
- 回滚思路：APT 升级后可快速回退到上一版本（如 sudo apt install jenkins=<旧版本>），并恢复备份数据目录；Web 界面“自动升级”通常仅适合小版本，跨大版本不建议依赖。
三 将 Jenkins 配置与任务纳入 Git 版本控制
- 推荐插件与能力：
- Job DSL Plugin：用 Groovy 定义/生成 Job，纳入 Git，便于批量管理与审计。
- SCM Sync Configuration Plugin：将 Jenkins 配置（Job、全局配置等）自动同步到 Git 仓库，形成“配置即代码”。
- 基本做法：
- 在 Manage Jenkins → Manage Plugins 安装上述插件；
- 配置 SCM Sync Configuration 指向你的 Git 仓库（建议私有仓库），设置分支、凭证与同步策略；
- 使用 Job DSL 编写 Job 模板并提交到 Git，Jenkins 按代码自动创建/更新任务；
- 定期在备份目录对 $JENKINS_HOME（如 /var/lib/jenkins）做离线快照，与 Git 形成双重保障。
四 在 Job 中使用 Git 管理业务代码
- 凭证与安全：
- SSH：在服务器生成密钥对（ssh-keygen），将公钥添加到 GitHub/GitLab SSH Keys；在 Manage Credentials 添加 “SSH Username with private key”（Username 填 git）。
- HTTPS：在 Git 平台生成 Personal Access Token，在 Jenkins 用 “Username with password” 凭证（密码填 Token）。
- 创建任务与源码管理：
- 新建 Freestyle 或 Pipeline 任务，源码管理选择 Git，填写仓库 URL（如 git@github.com:org/repo.git 或 https://github.com/org/repo.git），选择上一步的凭证，指定分支（如 */main）。
- 触发策略与流水线：
- 轮询：**Poll SCM H/5 * * * ***（每 5 分钟检查变更）。
- 事件驱动：在 Git 平台配置 Webhook，推送到 Jenkins 触发构建（减少延迟与空跑）。
- Pipeline：将 Jenkinsfile 纳入项目仓库，实现从构建、测试到部署的标准化流程。
五 版本号与发布回退策略
- 制品与版本文件：
- 在构建步骤生成版本标识，例如创建文件 rev.$PROJECT_NAME 并写入 $BUILD_NUMBER，将工作区打包为 $PROJECT_NAME.tar.gz，便于追踪构建来源。
- 版本化发布与回退：
- 将制品发布到版本目录（如 /data/work/release/$PROJECT/$PROJECT.$REV），通过软链接 /data/work/web/$PROJECT 指向当前版本；出现问题时，快速将软链接指向上一版本目录实现回退（rm -f $PROJECT && ln -s $PROJECT.$PREV $PROJECT）。
- 建议补充：
- 在 Git 使用 语义化版本（SemVer） 标签（如 v1.2.3），Jenkins 构建时读取标签生成制品版本；
- 将构建产物与 构建元数据（构建号、Git 提交、时间、变更列表）一并归档，便于审计与追溯。
