GitLab多项目CI/CD：子项目更新后如何标记子流水线为已通过？

问题场景 #

在GitLab多项目CI/CD流水线中，若子项目未完成生产环境部署就有新版本通过后续提交完成部署，子项目的生产部署触发按钮会进入阻塞状态（灰色不可点击），导致父项目流水线因该子项目未标记为已通过而无法完成。需配置.gitlab-ci.yml的trigger-subprojects段，让流水线在该场景下标记为已通过，同时确保所有子项目最终部署当前或更新版本。

Git Copilot给出的配置可行性分析 #

先看Copilot提供的配置代码：

trigger-subprojects:
  stage: triggers
  variables:
    UPSTREAM_PIPELINE_ID: $CI_PIPELINE_ID
  rules:
    - if: '$CI'
      when: always
  trigger:
    include:
      - artifact: generated-gitlab-ci.yml
        job: generate-yaml
    strategy: depend
  needs: [generate-yaml]
  script:
    - |
      if [ "$CI_JOB_STATUS" == "blocked" ]; then
        echo "Job is blocked, allowing failure."
        exit 0
      else
        echo "Job is not blocked, failing."
        exit 1
      fi

该配置完全不可行，核心问题如下：

1. script段不会执行：当任务使用trigger关键字时，GitLab仅将其作为子流水线的调度任务，不会执行script中的自定义逻辑，这段状态判断代码毫无作用。
2. 逻辑完全颠倒：即使script能执行，当前逻辑是阻塞状态返回成功、正常状态返回失败，与需求完全相悖，会导致正常流水线失败、阻塞流水线误判为成功，完全不符合业务预期。

正确配置方案 #

要解决该问题，需从子流水线状态处理、旧任务自动清理、版本验证三个维度入手：

1. 允许阻塞状态的子流水线标记为成功 #

通过allow_failure指定阻塞状态对应的退出码（GitLab中阻塞任务的退出码通常为123），让父流水线不会因子流水线阻塞而停滞：

trigger-subprojects:
  stage: triggers
  variables:
    UPSTREAM_PIPELINE_ID: $CI_PIPELINE_ID
  rules:
    - if: '$CI'
      when: always
  trigger:
    include:
      - artifact: generated-gitlab-ci.yml
        job: generate-yaml
    strategy: depend
  needs: [generate-yaml]
  allow_failure:
    exit_codes: 123

2. 子项目配置自动取消旧阻塞任务 #

在子项目的CI配置中，通过资源组和可中断属性，确保新流水线启动时自动取消旧的阻塞部署任务，让最新版本的流水线能正常推进：

# 子项目.gitlab-ci.yml中的生产部署任务
deploy-prod:
  stage: deploy
  rules:
    - if: '$CI_COMMIT_BRANCH == "main"'
      when: manual
      allow_failure: false
  script:
    - # 生产环境部署脚本
  resource_group: prod-deployment  # 确保同一时间仅一个部署任务执行
  interruptible: true  # 允许新流水线中断旧的阻塞任务

3. 父流水线验证最终部署版本 #

在父流水线末尾添加验证任务，通过GitLab API检查所有子项目的生产环境版本是否与当前流水线的提交哈希/版本标签一致，确保最终部署的是预期版本：

verify-deployments:
  stage: verify
  needs: [trigger-subprojects]
  script:
    - |
      # 遍历所有子项目，调用GitLab API获取生产环境最新部署的提交哈希
      # 对比当前父流水线的CI_COMMIT_SHA
      # 若不一致，触发子项目重新部署或标记任务失败
  rules:
    - if: '$CI'
      when: always

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