Jenkins Linux版如何进行版本控制

Jenkins Linux版版本控制实操指南

一 核心概念与目标

• 在 Linux 上，Jenkins 的“版本控制”通常包含两部分：
  1. 对应用源码的版本管理：使用 Git 或 Subversion（SVN） 拉取与追踪代码变更。
  2. 对 Jenkins 自身的配置与流水线即代码（Pipeline-as-Code）：将 Jenkinsfile 与 Job 配置纳入 Git 管理，实现可审计、可回滚与可迁移的 CI/CD 体系。

二 准备环境

• 安装 Java（Jenkins 需要 Java 8+），例如在 Debian/Ubuntu 上：
  • sudo apt update && sudo apt install -y openjdk-11-jdk
• 安装 Git（用于拉取代码与托管 Jenkinsfile）：
  • sudo apt install -y git
• 安装 Jenkins（Debian 系列示例）：
  • wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
  • echo “deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/” | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
  • sudo apt update && sudo apt install -y jenkins
• 首次访问 http://<主机>:8080，按页面提示完成解锁与初始化（创建管理员、安装推荐插件）。

三 将应用源码纳入版本控制

• 使用 Git
  • 安装插件：进入 Manage Jenkins → Manage Plugins，安装 Git plugin（如有需要可加装 GitHub Integration、Blue Ocean 等）。
  • 新建任务：选择 Pipeline，在 Pipeline 配置中勾选 Pipeline script from SCM，选择 Git，填写仓库 URL、凭据 与 分支（如 main）。
  • 示例 Jenkinsfile（置于仓库根目录）： pipeline { agent any stages { stage(‘Checkout’) { steps { git url: ‘https://github.com/your-org/your-repo.git’, branch: ‘main’ } } stage(‘Build & Test’) { steps { sh ‘./gradlew build’ } } } }
  • 保存并运行，Jenkins 会自动检出代码并执行构建流程。
• 使用 SVN
  • 安装插件：在 Manage Plugins 安装 Subversion Plugin。
  • 在任务配置的 源码管理 选择 Subversion，填写仓库 URL 与 凭据；在 构建触发器 可使用 Poll SCM 定时轮询（如 “H/2 * * * *” 表示每 2 分钟检查一次变更）。

四 将 Jenkins 配置与流水线纳入版本控制

• 推荐做法：把 Jenkinsfile 放在代码仓库中，配合 Multibranch Pipeline 或普通 Pipeline 项目，从 SCM 加载脚本，实现“流水线即代码”。
• 进阶做法：将 JENKINS_HOME（含 jobs/、config.xml 等）纳入 Git/SVN 管理，便于版本化与迁移。
  • 关键步骤：
    • 停止 Jenkins：sudo systemctl stop jenkins
    • 备份并迁移目录：将现有 ~/.jenkins（或 /var/lib/jenkins）纳入版本控制；或设置新的 JENKINS_HOME 路径（通过环境变量、系统属性或 JNDI 方式）。
    • 启动 Jenkins：sudo systemctl start jenkins
    • 在 Web 界面执行 Manage Jenkins → Reload Configuration from Disk 重新加载配置。
  • 注意：
    • 避免把工作空间（workspace/）纳入版本控制（工作区是构建产物与检出目录，非配置）。
    • 若使用 SVN 管理 JENKINS_HOME，需处理 .svn 目录与工作区 .svn 的干扰；常见做法是将 .jenkins 检出到独立目录，再按需复制配置，或使用脚本自动 add/delete/commit 同步变更。

五 版本化发布与回退实践

• 制品与版本文件
  • 在构建步骤生成“版本文件”，例如写入 BUILD_NUMBER 或 Git 提交 ID：
    • echo $BUILD_NUMBER > rev.$PROJECT_NAME
    • 打包：tar zcvf ${PROJECT_NAME}.tar.gz *
  • 通过 SSH 或制品仓库分发，并在目标环境按“版本目录 + 软链接”方式发布：
    • 解压到版本目录：${PROJECT_RELEASE_HOME}/${PROJECT_NAME}.${REV}
    • 切换软链接：ln -sfn ${PROJECT_RELEASE_HOME}/${PROJECT_NAME}.${REV} ${PROJECT_WEB_HOME}/${PROJECT_NAME}
• 快速回退
  • 直接调整软链接指向历史版本目录即可完成回退：
    • rm -f ${PROJECT_WEB_HOME}/${PROJECT_NAME}
    • ln -s ${PROJECT_RELEASE_HOME}/${PROJECT_NAME}.${PREV_REV} ${PROJECT_WEB_HOME}/${PROJECT_NAME}
• 触发策略
  • 在 GitHub/GitLab 侧配置 Webhook，实现 push/merge 即触发构建；或使用 Poll SCM 作为备选轮询机制。