背景介绍
在我们的 C++ 应用 的构建过程中,随着业务对异构架构(如 ARM 和 AMD)支持的需求不断增长,我们希望能够:
-
同时构建出适用于 ARM 和 AMD 架构的应用包;
-
两者构建过程独立但并发执行,节省整体构建时间;
-
如果任意一个架构构建失败,立即终止另一个任务,尽早失败反馈,节省资源和时间。
传统的 Jenkins 构建方式是串行或全部并行执行后再汇总结果,这与我们**"快速失败"**的目标相悖。因此,设计了以下解决方案。
技术目标
-
使用 Jenkins Pipeline 实现主 Job(app)触发两个子 Job 并发构建(如
app-arm
和 app-amd
); -
任意一方失败,立即终止所有构建任务;
-
具备可复用性、参数传递完整、流程清晰的 Pipeline 结构。
问题挑战
Jenkins 的 parallel
默认行为为:
等待所有分支完成,再汇总结果。即使某个子任务失败,也不会立刻终止其他任务。
我们需要主动启用一个选项来改变这一行为。
解决方案:使用 failFast
参数 + Scripted parallel
在 Jenkins Declarative Pipeline 中,我们使用 script
块嵌入 Scripted 风格的 parallel(failFast: true)
,达到"谁先失败就立刻全局失败退出"的效果。
实现代码
主 Job(app)Jenkinsfile 关键段如下:
pipeline {
agent { node { label 'multi-build' } }
stages {
stage('Parallel Build for ARM & AMD') {
steps {
script {
parallel(
'Build AMD': {
build job: 'app-amd_daily_v3',
parameters: [
string(name: 'appType', value: "${params.appType}"),
// ...其他参数略
]
},
'Build ARM': {
build job: 'app-arm_daily_v3',
parameters: [
string(name: 'appType', value: "${params.appType}"),
// ...其他参数略
]
},
failFast: true // 关键参数
)
}
}
}
}
}
效果
-
构建开始后,两个子任务并行执行;
-
如果 ARM 构建失败,AMD 构建立刻被中止;
-
如果两者均成功,主任务成功;
-
故障可立即感知并反馈,避免浪费编译资源。
附加优化建议
-
对子 Job 设置不同的 node 标签,实现架构隔离,例如:
agent { node { label 'arm-builder' } } // ARM agent { node { label 'amd-builder' } } // AMD
-
子 Job 中设置适当的
timeout
,避免死锁; -
使用邮件或企业微信通知机制,快速告警失败情况。
总结收获
本次实践充分利用了 Jenkins Pipeline 的 Scripted 嵌套能力,绕过了 Declarative 对 failFast
的限制,实现了高效、高反馈速度的多架构并行构建方案。这种模式非常适合:
-
多平台(arm64、amd64)构建;
-
多版本(企业版 / 开源版)并行验证;
-
CI 构建任务中敏捷反馈、高效利用资源的场景。