GitLab CI中如何获取触发当前流水线的上游特定工件？

needs:project 默认确实只会拉取指定项目/分支下最新成功流水线的工件，无法直接关联触发当前下游流水线的特定上游实例。针对上游触发下游的场景，要获取对应流水线的精准工件，有两种可靠方案：

方案1：用needs:project结合上游传递的流水线ID #

GitLab 的 needs:project 支持 pipeline 参数，可直接指定目标流水线的ID。只需在上游触发下游时传递自身流水线ID，下游即可精准拉取对应工件：

上游流水线（触发下游的配置） #

trigger_downstream:
  stage: trigger
  trigger:
    project: group/your-downstream-project
    branch: main
    variables:
      UPSTREAM_PIPELINE_ID: $CI_PIPELINE_ID
      UPSTREAM_PROJECT: $CI_PROJECT_PATH

下游流水线（拉取指定工件的配置） #

use_upstream_artifacts:
  stage: build
  needs:
    - project: $UPSTREAM_PROJECT
      job: your-upstream-job-name  # 上游生成工件的作业名称
      pipeline: $UPSTREAM_PIPELINE_ID  # 绑定触发当前流水线的上游ID
      artifacts: true
  script:
    # 直接使用下载的工件
    - ls -la ./path-to-artifacts

方案2：通过GitLab API手动下载工件 #

如果需要更灵活的控制（比如筛选特定工件、处理复杂权限），可以在下游通过API调用精准下载指定流水线的工件：

下游流水线配置示例 #

download_upstream_artifacts:
  stage: build
  script:
    # 调用GitLab API下载指定流水线的工件
    - |
      curl --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" \
           "https://your-gitlab-instance/api/v4/projects/$(echo $UPSTREAM_PROJECT | sed 's/\//%2F/g')/pipelines/$UPSTREAM_PIPELINE_ID/jobs/artifacts/main/download?job=your-upstream-job-name" \
           -o artifacts.zip
    - unzip artifacts.zip
  variables:
    # 需在项目变量中配置具备上游工件读取权限的API token
    GITLAB_API_TOKEN: $GITLAB_API_TOKEN

注意事项 #

• 确保下游流水线的运行账号（或API token）拥有读取上游项目工件的权限
• 上游传递的 UPSTREAM_PIPELINE_ID 和 UPSTREAM_PROJECT 变量必须在下游流水线中可见
• 跨群组场景需额外配置项目间的访问权限

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