CI/CD / 系统课时
拉取指定分支与提交代码
拉取指定分支与提交代码
流水线只有明确检出哪一个仓库、分支或提交,构建结果才具备可追溯性。本篇使用 Jenkins Pipeline 配置 Git 检出,并区分“跟随分支最新提交”和“固定到具体提交”两种构建方式。
学习目标
- 使用 Jenkins Pipeline 从 Git 仓库检出指定分支
- 理解工作区中的分支、提交与构建版本之间的关系
- 正确引用 Jenkins 中保存的仓库凭据
检出指定分支
对于普通单仓库流水线,可以使用 git 步骤指定仓库 URL 和分支。私有仓库不要把用户名、密码或令牌直接写进 Jenkinsfile,而应引用 Jenkins Credentials 中已有的凭据 ID。
下面是一个完整的 Declarative Pipeline 示例。将仓库地址、分支名和凭据 ID 替换为实际配置后运行。
pipeline {
agent any
stages {
stage('Checkout') {
steps {
git branch: 'release',
credentialsId: 'git-repo-credentials',
url: 'https://git.example.com/team/app.git'
}
}
stage('Verify') {
steps {
sh 'git rev-parse --abbrev-ref HEAD || true'
sh 'git rev-parse HEAD'
}
}
}
}预期输出
release
<ID>
Finished: SUCCESS<ID> 表示实际检出的 Git commit SHA,不同仓库和提交会得到不同值。凭据由 Jenkins 在执行检出时使用,不应把真实密钥写入 Jenkinsfile 或控制台输出。
分支和提交解决不同问题
指定 release 分支表示构建执行时获取该分支对应的提交。如果分支之后继续产生新提交,下次构建可能得到不同的 commit SHA。因此,分支适合表达持续变化的代码线,提交 ID 适合表达不可变的代码版本。

如果目标是重现一次历史构建,就不应只记录“当时构建了 release 分支”,还要保留该次构建实际使用的 commit SHA。这样即使分支已经向前移动,也能确定原构建对应的源代码。
精确检出一个提交
需要固定提交时,可以使用 checkout 配合 Git SCM 配置。下面是片段示例,依赖 Jenkins 已安装提供 Git SCM 能力的插件,并将 <ID> 替换为仓库中真实存在的完整 commit SHA。
checkout scmGit(
branches: [[name: '<ID>']],
userRemoteConfigs: [[
credentialsId: 'git-repo-credentials',
url: 'https://git.example.com/team/app.git'
]]
)
sh 'git rev-parse HEAD'预期输出
<ID>如果提交不存在于该远程仓库可获取的历史中,检出会失败。固定 commit 常用于重现历史构建、生产版本回滚验证或精确定位某次代码变化;日常持续集成通常仍以分支或多分支流水线提供的 SCM 上下文为入口。
检查实际检出的版本
检出成功不等于检出了预期代码。最直接的验证方式是执行 git rev-parse HEAD,并把得到的 SHA 与 Jenkins 构建记录、Webhook 事件或待发布版本对应起来。
还要注意 Jenkins 的 Git 检出可能处于 detached HEAD 等状态,因此不要只依赖当前本地分支名判断版本。commit SHA 才是确认本次工作区源码身份的可靠依据。对于私有仓库,则同时检查凭据 ID 是否存在、是否允许访问目标仓库,以及 Agent 到 Git 服务的网络是否可达。