Jenkins 多架构并发构建实战

背景介绍

在我们的 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 构建任务中敏捷反馈、高效利用资源的场景。