GitLab中如何在Alpha测试失败时阻止QA部署及分支校验？

针对你提出的「release/xxx分支无Alpha阶段，需回溯检查源分支（如master）Alpha测试是否通过，未通过则阻止QA部署」的需求，以下是GitLab原生实现的几种简便方案：

方案1：通过GitLab API检查源分支Alpha测试状态 #

在QA流水线启动前，新增前置检查步骤，调用GitLab API查询源分支（如master）最新的Alpha测试作业状态，未通过则终止流水线。

配置示例 #

# 前置检查：验证master分支Alpha测试状态
qa_validate_alpha:
  stage: pre-qa
  script:
    - |
      # 获取master分支最后一次成功流水线的ID
      PIPELINE_ID=$(curl --header "PRIVATE-TOKEN: $GITLAB_CI_TOKEN" "$CI_API_V4_URL/projects/$CI_PROJECT_ID/pipelines?ref=master&status=success&per_page=1" | jq -r '.[0].id')
      if [ -z "$PIPELINE_ID" ]; then
        echo "❌ master分支无成功流水线，阻止QA部署"
        exit 1
      fi
      # 查询该流水线中Alpha测试作业的状态
      ALPHA_JOB_STATUS=$(curl --header "PRIVATE-TOKEN: $GITLAB_CI_TOKEN" "$CI_API_V4_URL/projects/$CI_PROJECT_ID/pipelines/$PIPELINE_ID/jobs?name=alpha_test" | jq -r '.[0].status')
      if [ "$ALPHA_JOB_STATUS" != "success" ]; then
        echo "❌ master分支Alpha测试未通过，阻止QA部署"
        exit 1
      fi
      echo "✅ Alpha测试验证通过，允许QA部署"
  variables:
    GITLAB_CI_TOKEN: $GITLAB_CI_TOKEN # 需在项目CI/CD变量中配置具备read_api权限的token
  before_script:
    - apt-get update && apt-get install -y curl jq # 确保环境依赖齐全
  allow_failure: false
  only:
    - /^release\/.*$/

# QA部署作业，依赖前置检查通过
qa_deploy:
  stage: qa
  needs: ["qa_validate_alpha"]
  script:
    # 此处编写你的QA部署逻辑
  only:
    - /^release\/.*$/

注意事项 #

• 需将alpha_test替换为你实际的Alpha测试作业名称
• 确保GITLAB_CI_TOKEN拥有项目的read_api权限

方案2：通过跨流水线工件传递Alpha测试状态 #

在master分支的Alpha测试通过后，生成一个标记文件作为工件；release分支的QA流水线依赖该工件，只有当工件存在时才允许运行。

master分支Alpha作业配置 #

alpha_test:
  stage: alpha
  script:
    # 此处编写你的Alpha测试逻辑
    - touch alpha_passed.txt # 测试通过后生成标记文件
  artifacts:
    paths:
      - alpha_passed.txt
    expire_in: 7d # 按需设置工件过期时间
  only:
    - master
  allow_failure: false

release分支QA配置 #

# 前置检查：拉取master分支的Alpha测试工件
qa_check_alpha_artifact:
  stage: pre-qa
  needs:
    - project: $CI_PROJECT_PATH
      job: alpha_test
      ref: master
      artifacts: true
  script:
    - if [ ! -f alpha_passed.txt ]; then echo "❌ Alpha测试未通过，阻止QA部署"; exit 1; fi
    echo "✅ Alpha测试验证通过"
  only:
    - /^release\/.*$/
  allow_failure: false

qa_deploy:
  stage: qa
  needs: ["qa_check_alpha_artifact"]
  script:
    # 此处编写你的QA部署逻辑
  only:
    - /^release\/.*$/

注意事项 #

• 该方案依赖master分支最新成功的Alpha测试工件，若需严格对应release分支从master分出的特定提交，可结合提交SHA查询（需额外传递分支创建时的源提交ID）

方案3：通过CI/CD变量标记Alpha状态（全局验证） #

在master分支Alpha测试通过后，设置项目级保护变量；release分支的QA流水线检查该变量，未设置则终止运行。

master分支Alpha作业配置 #

alpha_test:
  stage: alpha
  script:
    # 此处编写你的Alpha测试逻辑
    # 设置项目级保护变量标记Alpha测试通过
    - curl --request PUT --header "PRIVATE-TOKEN: $GITLAB_CI_TOKEN" "$CI_API_V4_URL/projects/$CI_PROJECT_ID/variables/ALPHA_PASSED" --form "value=true" --form "protected=true"
  only:
    - master
  allow_failure: false

release分支QA配置 #

qa_deploy:
  stage: qa
  script:
    - if [ "$ALPHA_PASSED" != "true" ]; then echo "❌ Alpha测试未通过，阻止QA部署"; exit 1; fi
    # 此处编写你的QA部署逻辑
  only:
    - /^release\/.*$/
  variables:
    ALPHA_PASSED: $ALPHA_PASSED # 继承项目级保护变量
  allow_failure: false

注意事项 #

• 该方案为全局标记，适合所有release分支依赖最新master Alpha状态的场景，若需针对特定提交验证则不适用
• 需确保GITLAB_CI_TOKEN拥有项目的api权限

对你已尝试方法的优化 #

• allow_failure: true应改为false，确保Alpha测试失败时直接终止流水线，避免后续流程触发
• needs:project可结合方案2的工件传递逻辑，实现跨流水线的状态验证

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