使用Trigger API触发跨项目下游流水线后，如何追踪其状态？

解决方法 #

一、追踪触发后的流水线状态 #

Trigger API触发成功后会返回下游流水线的完整信息（包括ID、状态、Web地址等），可以通过以下方式实现状态追踪：

1. 捕获流水线信息并输出到日志
   在触发命令中保存API响应，提取关键信息后打印到CI日志，方便直接跳转查看：

   # 触发流水线并保存响应结果
   PIPELINE_RESPONSE=$(curl -X POST \
     --form token=$YOU_TRIGGER_TOKEN_VARIABLE \
     --form ref=target_branch \
     "$CI_API_V4_URL/projects/55/trigger/pipeline")
   
   # 用jq提取流水线ID和Web地址（需确保CI环境已安装jq）
   PIPELINE_ID=$(echo "$PIPELINE_RESPONSE" | jq -r '.id')
   PIPELINE_URL=$(echo "$PIPELINE_RESPONSE" | jq -r '.web_url')
   
   # 输出到日志，可直接点击链接查看下游流水线
   echo "已触发下游流水线，ID: $PIPELINE_ID"
   echo "流水线详情页: $PIPELINE_URL"
   

2. 轮询API实时检查状态
   通过GitLab的流水线详情API轮询状态，直到流水线进入结束状态（成功/失败/取消等），实现类似UI上的状态追踪：

   # 循环查询流水线状态
   while true; do
     # 获取当前状态
     PIPELINE_STATUS=$(curl -s "$CI_API_V4_URL/projects/55/pipelines/$PIPELINE_ID" | jq -r '.status')
     echo "当前下游流水线状态: $PIPELINE_STATUS"
   
     # 判断是否为结束状态
     case $PIPELINE_STATUS in
       "success"|"failed"|"canceled"|"skipped")
         echo "下游流水线执行完成，最终状态: $PIPELINE_STATUS"
         break
         ;;
       *)
         echo "流水线执行中，10秒后再次查询..."
         sleep 10
         ;;
     esac
   done
   

二、替代strategy:depend的功能 #

要实现和trigger:project中strategy:depend一样的“上游等待下游完成，下游失败则上游也失败”的效果，只需在轮询状态的代码中添加退出码判断：

while true; do
  PIPELINE_STATUS=$(curl -s "$CI_API_V4_URL/projects/55/pipelines/$PIPELINE_ID" | jq -r '.status')
  echo "当前下游流水线状态: $PIPELINE_STATUS"

  case $PIPELINE_STATUS in
    "success")
      echo "下游流水线执行成功"
      exit 0
      ;;
    "failed"|"canceled")
      echo "下游流水线执行失败或被取消，上游流水线将终止"
      exit 1
      ;;
    "skipped")
      echo "下游流水线被跳过"
      exit 0
      ;;
    *)
      sleep 10
      ;;
  esac
done

这样当下游流水线失败时，上游流水线会以非零码退出，等同于strategy:depend的依赖效果。

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