CI/CD / 系统课时
限制同一任务的并发构建
限制同一任务的并发构建
当流水线会部署到同一测试环境、更新共享目录或操作同一外部资源时,并发构建可能互相覆盖。本节使用 Jenkins Pipeline 的 disableConcurrentBuilds 阻止同一任务同时执行,并理解等待与取消旧构建两种策略的差异。
学习目标
- 使用
disableConcurrentBuilds限制同一 Pipeline Job 的并发执行 - 理解排队等待与
abortPrevious两种行为 - 判断哪些共享资源场景需要串行构建
并发为什么会破坏部署结果
假设一次提交 A 正在向共享测试环境部署版本 A,此时提交 B 又触发同一个 Job。两个构建可能同时执行上传、数据库迁移或容器替换,最终环境状态不一定对应较新的构建。
并发限制针对的是同一个 Jenkins Job 的多个构建。它并不会自动锁住其他 Job,也不会保护 Jenkins 之外的共享资源。若多个不同 Job 操作同一环境,需要额外设计跨任务的资源互斥机制。

在 Declarative Pipeline 中禁止并发
Declarative Pipeline 可以在顶层 options 中启用 disableConcurrentBuilds()。下面的 Jenkinsfile 可直接展示核心行为:同一 Job 的当前构建未结束时,新构建进入队列等待。
pipeline {
agent any
options {
// 同一 Job 同一时间只允许一个构建进入执行阶段
disableConcurrentBuilds()
}
stages {
stage('Deploy') {
steps {
echo "Deploying build ${env.BUILD_NUMBER}"
sleep time: 30, unit: 'SECONDS'
}
}
}
}预期输出
Deploying build <ID><ID> 是 Jenkins 分配的实际构建编号,具体值会不同。在这 30 秒内再次触发同一个 Job,新构建应先处于队列等待状态,而不是与当前构建同时进入 Deploy。
需要新构建取代旧构建时
某些流水线只关心最新提交,例如持续更新同一个临时预览环境。此时让大量旧构建排队没有意义,可以使用 abortPrevious: true:
options {
disableConcurrentBuilds(abortPrevious: true)
}这是片段示例,应放在 Declarative Pipeline 顶层 pipeline 的 options 块中。新构建启动时,仍在运行的旧构建会被中止,而不是等待旧构建完成后再执行。
选择策略时要看操作是否允许中断。普通编译和临时环境部署通常较容易重试;数据库迁移、发布切流等操作若在中途被强制终止可能留下中间状态,不应仅为了追求最新构建而直接启用 abortPrevious。
验证限制是否真正生效
保存 Jenkinsfile 后,连续触发同一个 Job 两次。使用默认的 disableConcurrentBuilds() 时,第一条构建保持执行,第二条应等待;第一条结束后,第二条才获得执行机会。
验证时不要只看两个构建最终是否成功,还要确认它们的执行时间没有重叠。若仍发生共享环境冲突,应进一步确认冲突是否来自不同 Job:这种情况已经超出 disableConcurrentBuilds 的保护范围。
并发控制的目标不是让所有流水线都串行,而是把互斥范围放在真正不能并发修改的资源上。对同一 Job 整体串行最简单,但也会降低吞吐量;只有确实共享部署环境、目录或不可并行操作的资源时,才值得承担这项等待成本。