GitLab按序触发子流水线失败及依赖等待问题排查

一、根流水线找不到子项目文件的原因 #

你当前用的trigger.include是将子项目的CI配置导入到根流水线中执行，Job运行的上下文是根项目的代码仓库，而非子ProjectA的仓库，所以自然找不到ProjectA里的requirements.txt。这种方式本质是复用CI配置，不是触发独立的子项目流水线。

二、实现按序触发独立子项目流水线（前序成功再执行下一个） #

要触发子项目自己的流水线，需要用跨项目触发器，而非include方式，同时配合strategy: depend和needs控制执行顺序。

1. ProjectRoot 配置修改 #

将根项目的.gitlab-ci.yml调整为以下形式，用project指定子项目路径：

...
root:
  stage: root
  script:
    - echo "Root job completed"

projecta:
  stage: trigger
  trigger:
    project: app/projecta  # 填写GitLab中子项目的完整路径，如group/app/projecta
    ref: test
  strategy: depend  # 等待子流水线执行完成，同步其状态
  needs:
    - root  # 确保在root job成功后才触发
  when: on_success

projectb:
  stage: trigger
  trigger:
    project: app/projectb
    ref: test
  strategy: depend
  needs:
    - projecta  # 依赖ProjectA的子流水线成功完成
  when: on_success
...

• strategy: depend会让根流水线的trigger job等待子流水线结束，子流水线成功则该job成功，失败则该job失败。
• needs用来强制顺序，保证projecta在root完成后启动，projectb在projecta的子流水线成功后启动。

2. 子项目配置无需改动 #

ProjectA/ProjectB的.gitlab-ci.yml保持原有配置即可，因为此时触发的是子项目自身的流水线，运行上下文是子项目的代码仓库，能正常读取requirements.txt。

三、curl触发流水线实现依赖等待的解决方案 #

用curl触发流水线默认是异步的，要实现等待前序流水线成功再触发下一个，需结合GitLab API编写轮询脚本，查询前序流水线状态，直到成功后再触发下一个。

示例Bash脚本 #

#!/bin/bash

# GitLab 基础配置
GITLAB_URL="https://你的GitLab实例地址"
PRIVATE_TOKEN="你的个人访问令牌"  # 需要拥有API权限和流水线触发权限

# 触发指定项目的流水线，返回流水线ID
trigger_pipeline() {
  PROJECT_PATH=$1
  RESPONSE=$(curl -s -X POST "$GITLAB_URL/api/v4/projects/$PROJECT_PATH/pipeline?ref=test" \
    -H "PRIVATE-TOKEN: $PRIVATE_TOKEN")
  echo "$RESPONSE" | jq -r '.id'
}

# 轮询流水线状态，直到成功或失败/取消
wait_for_pipeline_success() {
  PIPELINE_ID=$1
  PROJECT_PATH=$2
  while true; do
    STATUS=$(curl -s "$GITLAB_URL/api/v4/projects/$PROJECT_PATH/pipelines/$PIPELINE_ID" \
      -H "PRIVATE-TOKEN: $PRIVATE_TOKEN" | jq -r '.status')
    if [ "$STATUS" = "success" ]; then
      echo "流水线 $PIPELINE_ID 执行成功"
      break
    elif [ "$STATUS" = "failed" ] || [ "$STATUS" = "canceled" ]; then
      echo "流水线 $PIPELINE_ID 执行失败/已取消"
      exit 1
    fi
    echo "流水线 $PIPELINE_ID 当前状态: $STATUS，等待中..."
    sleep 30
  done
}

# 执行流程
echo "触发ProjectA流水线..."
PROJECTA_PIPELINE_ID=$(trigger_pipeline "app%2Fprojecta")  # 项目路径中的/需转义为%2F
wait_for_pipeline_success "$PROJECTA_PIPELINE_ID" "app%2Fprojecta"

echo "触发ProjectB流水线..."
PROJECTB_PIPELINE_ID=$(trigger_pipeline "app%2Fprojectb")
wait_for_pipeline_success "$PROJECTB_PIPELINE_ID" "app%2Fprojectb"

• 注意：项目路径里的/必须转义为%2F，比如app/projecta要写成app%2Fprojecta。
• 个人访问令牌需要开启api、read_repository等必要权限。
• 脚本依赖jq工具解析JSON响应，需提前安装。

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