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
相关产品推荐
相关产品推荐

