如何让GitLab CI流水线在build阶段任一Job失败时立即终止？

方案一：全局启用快速失败（推荐） #

在你的.gitlab-ci.yml文件顶部添加fail_fast: true配置，这会让GitLab CI在检测到任意一个allow_failure: false的Job失败时，立即终止所有正在运行的Job，并且不再启动后续的Job，完全匹配你的需求。

示例配置：

fail_fast: true

stages:
  - build
  - test
  - deploy

build_app:
  stage: build
  script:
    - echo "编译应用"
    - # 模拟失败场景
    - exit 1

build_docs:
  stage: build
  script:
    - echo "构建文档"
    - sleep 15
    - echo "文档构建完成"

当build_app失败后，正在运行的build_docs会被立即终止，流水线直接标记为失败，无需等待所有build阶段Job完成。

方案二：仅针对build阶段串行执行（适合分阶段控制场景） #

如果你只希望build阶段启用失败即终止逻辑，且可以接受放弃并行构建效率，可通过needs关键字将build阶段的Job设置为串行执行。这样前一个Job失败时，后续的Job不会被启动。

示例配置：

stages:
  - build
  - test

build_step1:
  stage: build
  script:
    - echo "执行构建步骤1"
    - exit 1

build_step2:
  stage: build
  needs: [build_step1]
  script:
    - echo "执行构建步骤2"

build_step3:
  stage: build
  needs: [build_step2]
  script:
    - echo "执行构建步骤3"

这种方式的缺点是build阶段的Job无法并行运行，会增加整体构建时间。

方案三：自定义API检查逻辑（复杂场景备选） #

如果必须保持build阶段Job并行，且仅针对该阶段实现失败即终止，可以在每个build Job的脚本中定期调用GitLab API，查询同阶段其他Job的状态，若发现失败则主动退出当前Job。这种方法需要配置GitLab访问令牌，且脚本逻辑较复杂，仅在特殊需求下使用。

内容的提问来源于stack exchange，提问作者RareScrap