You need to enable JavaScript to run this app. Declarative Pipeline并行报错时如何即时中止Jenkins job 无需等待其他分支执行
优惠活动
大模型
产品
解决方案
定价
更多

Declarative Pipeline并行报错时如何即时中止Jenkins job 无需等待其他分支执行

Declarative Pipeline 并行分支任意失败立即终止配置方法

默认场景下,Declarative Pipeline 的并行块会等待所有分支执行结束后再汇总结果判定最终状态,即便有分支提前报错,也会等其他长耗时分支跑完才标记任务失败,会造成大量无效等待。

核心实现逻辑

只需要给并行块增加failFast: true参数即可实现目标:

  • 参数作用:并行组内任意一个分支抛出未捕获的错误时,会立即向其他仍在运行的并行分支发送终止信号,直接标记整个流水线为失败,无需等待剩余分支执行完成
  • 对比默认行为:默认failFast: false时,无论分支是否提前失败,都会等所有分支执行完毕再做结果判定,长耗时场景下会造成大量无效等待。

修正后可直接运行的Pipeline示例

pipeline {
    agent any
    stages {
        stage('Parallel Stage') {
            steps {
                parallel(
                    // 开启任意失败立即终止其他并行分支的能力
                    failFast: true,
                    'group1': {
                        sleep 10
                        echo 'Completed step1'
                    },
                    'group2': {
                        sleep 5
                        error 'Error in step2'
                    }
                )
            }
        }
    }
}

实际运行效果

以上示例执行时,group2 会在第5秒抛出错误,此时系统会立刻终止还在等待10秒的group1分支,整个流水线在第5秒左右就会标记为失败,相比原来需要等满10秒才能判定失败的流程,可直接省下剩余分支的无效等待时间。

注意事项

  • failFast参数需要和各个并行分支的定义同级,放在parallel方法的参数列表中,不要错误嵌套到分支块内部
  • 若并行分支内使用try-catch捕获了所有异常,没有将错误向外抛出,failFast将无法感知分支失败,不会触发全局终止逻辑
  • 该能力从Jenkins LTS 2.289版本开始原生支持,配套的声明式Pipeline插件版本≥2.200即可正常使用,无需额外安装扩展插件

内容的提问来源于stack exchange,提问作者np2807

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 01:36:04