CI/CD / 系统课时
取消旧构建避免覆盖新版本
取消旧构建避免覆盖新版本
同一分支连续提交时,旧构建可能因为测试较慢而晚于新构建进入部署阶段,最终把生产环境重新覆盖成旧版本。本节用 Jenkins Pipeline 的并发控制让过期构建尽快退出,并说明为什么部署阶段仍需要额外保护。
学习目标
- 理解连续构建为什么会产生版本覆盖竞争
- 使用
disableConcurrentBuilds(abortPrevious: true)取消同一 Job 的旧构建 - 为部署阶段增加版本校验,避免过期任务覆盖新版本
版本为什么会倒退
假设提交 A 触发构建 #101,随后提交 B 触发构建 #102。#101 的测试耗时较长,而 #102 很快通过测试并部署 B。如果 #101 随后继续执行部署,它就可能再次部署 A,使线上版本从 B 倒退到 A。

这里的问题不是单次构建失败,而是多个构建同时拥有修改同一部署目标的资格。只依赖构建编号或开始时间不能自动解决竞争,必须明确规定旧构建在新构建出现后应如何处理。
自动中止旧构建
Declarative Pipeline 可以在 options 中使用 disableConcurrentBuilds(abortPrevious: true)。当同一 Job 的新构建开始后,仍在运行的旧构建会被中止,而不是继续与新构建并发执行。
pipeline {
agent any
options {
disableConcurrentBuilds(abortPrevious: true)
}
stages {
stage('Build') {
steps {
echo "Building ${env.GIT_COMMIT}"
}
}
stage('Test') {
steps {
sh 'npm test'
}
}
stage('Deploy') {
steps {
echo "Deploying ${env.GIT_COMMIT}"
sh './deploy.sh'
}
}
}
}这是完整 Jenkinsfile 示例,但要求工作区中的项目已经提供可执行的 npm test 和 ./deploy.sh。实际提交哈希、构建编号和执行时间会随运行变化。
预期结果
旧构建:新构建启动后被 Jenkins 中止,不再继续执行后续阶段
新构建:独占该 Job 的执行机会,并继续完成 Build、Test 和 Deploy如果只写 disableConcurrentBuilds() 而不启用 abortPrevious,新构建会等待旧构建结束。这能避免两个构建同时执行,却不能满足“新提交应尽快淘汰旧提交”的持续交付需求。
不要把取消构建当成部署事务
取消旧构建只能阻止尚未执行的后续步骤。如果旧构建已经把部署请求发送给外部平台,Jenkins 中止执行并不意味着外部部署一定会自动回滚或停止。例如异步发布系统可能已经接收旧版本任务,并继续在 Jenkins 之外运行。
因此生产部署最好同时携带不可变版本标识,例如 Git commit、镜像 digest 或唯一制品版本。部署系统应拒绝明显过期的版本,或者由单一发布控制器按期望版本收敛环境。这样即使 Jenkins 的取消发生得稍晚,也不会只靠进程中止维持正确顺序。
验证取消行为
可以在测试 Job 中临时加入等待,让第一次构建保持运行,再快速触发第二次构建。下面的片段示例用于替换测试 Job 中的某个测试阶段,不应直接用于真实生产流水线。
stage('Slow Test') {
steps {
echo "Running build ${env.BUILD_NUMBER}"
sleep time: 60, unit: 'SECONDS'
}
}预期结果
第一次构建进入 Slow Test
第二次构建启动
第一次构建被标记为中止并停止后续执行
第二次构建继续运行最终还应检查部署目标的版本标识,确认环境对应最新提交,而不只是看到 Jenkins 中旧构建显示为已中止。取消旧任务解决的是执行竞争,版本校验解决的是最终部署正确性,两层保护结合后才更适合生产发布。