如何仅在所有子项目流水线完成后触发GitLab CI公共流水线？

推荐方案：无需自定义API脚本的原生实现方式 #

1. 跨项目流水线依赖（GitLab 13.10+支持） #

如果子项目和公共项目在同一GitLab实例下，直接用needs关键字定义跨项目依赖，让公共项目流水线自动等待所有子项目指定作业完成后启动：

stages:
  - run_common

run_common_job:
  stage: run_common
  needs:
    - project: group/sub-project-1
      job: build
      ref: main  # 按需指定子项目分支
    - project: group/sub-project-2
      job: test
      ref: main
  script:
    - echo "所有子项目流水线已完成，执行公共项目逻辑"
  only:
    - main

这种方式完全依赖GitLab原生能力，无需手动编写状态检查脚本。

2. 流水线状态检查+受保护触发器 #

如果子项目触发时机不固定，可通过以下两步实现：

• 在公共项目设置中启用流水线状态检查，添加所有子项目的流水线状态作为检查项（要求子项目最新流水线必须成功）。
• 给公共项目配置受保护触发器，让每个子项目流水线完成后调用该触发器API。此时公共项目流水线不会立即执行，只有当所有子项目的流水线状态都满足要求时才会启动。

3. 群组流水线（同群组内项目适用） #

若所有子项目属于同一群组，可配置群组级流水线，将子项目流水线纳入群组流程，最后统一触发公共项目：

# 群组级.gitlab-ci.yml
stages:
  - sub_projects
  - common_project

trigger_sub_projects:
  stage: sub_projects
  trigger:
    include:
      - project: group/sub-project-1
        file: .gitlab-ci.yml
      - project: group/sub-project-2
        file: .gitlab-ci.yml
  strategy: depend  # 等待所有子项目流水线完成

trigger_common:
  stage: common_project
  script:
    - echo "触发公共项目流水线"
    - curl -X POST "https://your-gitlab-instance/api/v4/projects/<公共项目ID>/trigger/pipeline" --form "token=<触发器令牌>" --form "ref=main"

strategy: depend会确保群组流水线等待所有子项目流水线结束后，再执行公共项目触发步骤。

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