CI/CD / 系统课时

限制同一任务的并发构建

限制同一任务的并发构建

当流水线会部署到同一测试环境、更新共享目录或操作同一外部资源时,并发构建可能互相覆盖。本节使用 Jenkins Pipeline 的 disableConcurrentBuilds 阻止同一任务同时执行,并理解等待与取消旧构建两种策略的差异。

学习目标

  • 使用 disableConcurrentBuilds 限制同一 Pipeline Job 的并发执行
  • 理解排队等待与 abortPrevious 两种行为
  • 判断哪些共享资源场景需要串行构建

并发为什么会破坏部署结果

假设一次提交 A 正在向共享测试环境部署版本 A,此时提交 B 又触发同一个 Job。两个构建可能同时执行上传、数据库迁移或容器替换,最终环境状态不一定对应较新的构建。

并发限制针对的是同一个 Jenkins Job 的多个构建。它并不会自动锁住其他 Job,也不会保护 Jenkins 之外的共享资源。若多个不同 Job 操作同一环境,需要额外设计跨任务的资源互斥机制。

同一 Jenkins Job 从并发执行变为串行排队的关系示意

在 Declarative Pipeline 中禁止并发

Declarative Pipeline 可以在顶层 options 中启用 disableConcurrentBuilds()。下面的 Jenkinsfile 可直接展示核心行为:同一 Job 的当前构建未结束时,新构建进入队列等待。

groovy
pipeline {
    agent any

    options {
        // 同一 Job 同一时间只允许一个构建进入执行阶段
        disableConcurrentBuilds()
    }

    stages {
        stage('Deploy') {
            steps {
                echo "Deploying build ${env.BUILD_NUMBER}"
                sleep time: 30, unit: 'SECONDS'
            }
        }
    }
}

预期输出

text
Deploying build <ID>

<ID> 是 Jenkins 分配的实际构建编号,具体值会不同。在这 30 秒内再次触发同一个 Job,新构建应先处于队列等待状态,而不是与当前构建同时进入 Deploy。

需要新构建取代旧构建时

某些流水线只关心最新提交,例如持续更新同一个临时预览环境。此时让大量旧构建排队没有意义,可以使用 abortPrevious: true:

groovy
options {
    disableConcurrentBuilds(abortPrevious: true)
}

这是片段示例,应放在 Declarative Pipeline 顶层 pipeline 的 options 块中。新构建启动时,仍在运行的旧构建会被中止,而不是等待旧构建完成后再执行。

选择策略时要看操作是否允许中断。普通编译和临时环境部署通常较容易重试;数据库迁移、发布切流等操作若在中途被强制终止可能留下中间状态,不应仅为了追求最新构建而直接启用 abortPrevious。

验证限制是否真正生效

保存 Jenkinsfile 后,连续触发同一个 Job 两次。使用默认的 disableConcurrentBuilds() 时,第一条构建保持执行,第二条应等待;第一条结束后,第二条才获得执行机会。

验证时不要只看两个构建最终是否成功,还要确认它们的执行时间没有重叠。若仍发生共享环境冲突,应进一步确认冲突是否来自不同 Job:这种情况已经超出 disableConcurrentBuilds 的保护范围。

并发控制的目标不是让所有流水线都串行,而是把互斥范围放在真正不能并发修改的资源上。对同一 Job 整体串行最简单,但也会降低吞吐量;只有确实共享部署环境、目录或不可并行操作的资源时,才值得承担这项等待成本。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

限制同一任务的并发构建

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通