Azure DevOps YAML管道下载artifact时如何获取对应runID

问题背景 #

• 场景需求：独立YAML管道中消费另一条管道生成的artifact，需要获取生成目标artifact对应的源管道运行runID。
• 原有全局资源方案：在消费管道全局resources段声明管道资源时，可直接通过预定义变量$(resources.pipeline.<artifactName>.runID)获取runID，该方案会将artifact下载到管道全局可用路径，配置如下：

resources:
  pipelines:
  - pipeline: <artifactName>
    source: <pipelineName>

• 当前调整后的方案：不再使用全局资源声明，仅在特定阶段使用DownloadPipelineArtifact@2任务，按管道运行标签筛选下载指定artifact到当前阶段（避免全局下载占用多余资源），任务配置如下：

- task: DownloadPipelineArtifact@2
  inputs:
    source: 'specific'
    project: '<myProjectName>'
    pipeline: <firstPipelineID>
    artifact: '<artifactName>'
    targetPath: $(Pipeline.Workspace)
    tags: <myTag>

• 现存问题：尝试使用$(Pipeline.Workspace.<artifactName>.runID)获取runID始终无有效值，需要该场景下的正确取值方法。

原因说明 #

$(Pipeline.Workspace.<artifactName>.runID)不属于DownloadPipelineArtifact@2任务场景下的合法预定义变量：只有全局resources声明引入的管道资源，才会自动注入resources.pipeline.*系列预定义变量，单独使用下载任务时不会自动生成这类全局变量，因此无法取到值。

可行实现方案 #

方案1：直接读取下载任务的内置输出变量 #

DownloadPipelineArtifact@2任务执行完成后，会自动输出名为BuildId的任务级变量，该值就是所下载artifact对应的源管道运行ID（即需要的runID）。使用时只需要给下载任务设置自定义名称，同Job内的后续步骤可直接引用该变量，示例配置：

- task: DownloadPipelineArtifact@2
  name: FetchArtifact # 自定义任务名，用于后续变量引用
  inputs:
    source: 'specific'
    project: '<myProjectName>'
    pipeline: <firstPipelineID>
    artifact: '<artifactName>'
    targetPath: $(Pipeline.Workspace)
    tags: <myTag>

# 后续步骤直接引用即可拿到runID
- pwsh: |
    Write-Host "源管道runID为: $(FetchArtifact.BuildId)"

若需要跨Job引用该值，需将该变量标记为Job输出变量，下游Job通过依赖关系声明后即可引用。

方案2：提前查询匹配标签的runID再执行下载 #

如果需要在下载artifact前就拿到目标runID，可在执行下载任务前，使用管道内置的System.AccessToken鉴权，调用Azure DevOps管道运行查询接口，按标签筛选出匹配的最新运行ID：

1. 传入目标管道ID、标签筛选条件查询运行列表
2. 解析返回结果提取匹配的runID
3. 将提取到的runID同时传给下载任务的runId参数，以及后续需要使用runID的步骤即可

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