Azure DevOps：如何通过指定标签获取最新工件以自动创建发布

安全阿岳

2026-6-21

问题描述

我们有一条统一的流水线，负责编译并运行master和dev分支的测试用例。
该流水线是所有拉取请求（PR）的前置校验环节，确保没有损坏代码被合并到这两个分支。
我们选择单条流水线的原因是它能持续递增构建编号——如果为每个分支单独创建流水线，发布到master时构建编号会重置。
我们还有一条发布流水线，需要在PR合并到master后，从上述测试流水线拉取工件并完成应用发布。

当前困境

我们无法自动化最后一步：发布流水线无法拉取master分支对应的工件，因为测试流水线是在PR分支（而非master本身）上运行的。

我们已经给测试流水线打了标签，也能定位到最后一次针对master分支PR的流水线运行记录，但发布流水线仅允许指定流水线的默认分支或特定分支的标签——而每个PR对应的分支都是不同的。

有没有办法直接拉取带有特定标签的最新工件？我们是否遗漏了某些能满足需求的配置？

更新说明

应Kevin的要求，附上我们尝试按分支拉取工件的配置（该方法无效，因为流水线的默认分支是dev，而非实际运行流水线的PR分支）：
Source Artifacts Setup

解决方案建议

1. 通过CI/CD平台API拉取带特定标签的最新工件

主流CI/CD平台（如Azure DevOps、GitHub Actions、GitLab CI）都提供REST API，可通过标签查询流水线运行记录。你可以在发布流水线中添加自定义步骤：

调用平台API，获取带有目标标签（比如pr-merged-to-master）的最新流水线运行记录。
从API响应中提取工件下载链接。
通过该链接将工件拉取到发布流水线中。

以Azure DevOps为例，可添加PowerShell步骤执行以下逻辑：

$orgUrl = "https://dev.azure.com/你的组织名"
$project = "你的项目名"
$pipelineId = "测试流水线ID"
$tag = "pr-merged-to-master"

# 获取带目标标签的最新流水线运行记录
$runs = Invoke-RestMethod -Uri "$orgUrl/$project/_apis/pipelines/$pipelineId/runs?tags=$tag&`$top=1&api-version=7.1-preview.1" -Headers @{Authorization = "Bearer $env:SYSTEM_ACCESSTOKEN"}
$latestRunId = $runs.value[0].id

# 获取工件下载链接
$artifacts = Invoke-RestMethod -Uri "$orgUrl/$project/_apis/pipelines/$pipelineId/runs/$latestRunId/artifacts?api-version=7.1-preview.1" -Headers @{Authorization = "Bearer $env:SYSTEM_ACCESSTOKEN"}
$artifactUrl = $artifacts.value[0].resource.downloadUrl

# 下载工件
Invoke-WebRequest -Uri $artifactUrl -OutFile "artifact.zip" -Headers @{Authorization = "Bearer $env:SYSTEM_ACCESSTOKEN"}

2. 调整标签策略，加入目标分支标识

当测试流水线针对master分支的PR运行时，给流水线同时打上PR标识和target:master标签。之后在发布流水线中，配置拉取带有target:master标签的最新运行记录——这样就绕过了分支限制，因为标签明确标记了PR的目标分支。

多数CI/CD工具支持在流水线执行时动态打标签。比如GitHub Actions中可添加以下步骤：

- name: 为master分支PR打标签
  if: github.base_ref == 'refs/heads/master'
  run: |
    gh run edit ${{ github.run_id }} --add-tag "target:master"
  env:
    GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

3. 将符合条件的工件推送到专属发布源

修改测试流水线逻辑：当PR目标为master时，将工件推送到专属的包管理源（如Azure Artifacts、GitHub Packages），并为工件打上构建编号和master标识。之后发布流水线直接从该源拉取带有master标签的最新工件。

这种方式增加了中间环节，但能彻底将发布流水线与测试流水线的分支上下文解耦。

4. 基于标签设置流水线触发规则

如果你的CI/CD平台支持，可为发布流水线设置触发规则：当带有target:master标签的测试流水线运行完成后，自动触发发布流水线。部分工具支持按标签过滤触发事件，这样就能自动拉取对应工件，无需手动选择分支。

注意事项

确保运行发布流水线的服务账号拥有查询流水线记录和下载工件的权限。
先在 staging 环境测试API调用或标签触发逻辑，避免影响正式发布流程。

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

Azure DevOps：如何通过指定标签获取最新工件以自动创建发布

问题描述 #

当前困境 #

更新说明 #

解决方案建议 #