Azure DevOps YAML流水线：如何基于构建运行名设置发布名称

核心问题 #

如何让YAML部署流水线的环境「状态」列显示的发布名称，自动关联触发它的构建流水线的运行名（或其定义的版本号）？

问题原因分析 #

• ##vso[build.updatebuildnumber]仅能修改流水线本身的运行名称，无法同步更新环境中显示的发布名称（环境发布名默认与流水线运行名绑定，但初始化后不会自动跟随后续修改）。
• ##vso[release.updatereleasename]仅适用于经典发布流水线，YAML流水线的System.HostType始终为build，不支持该命令。
• 根级name:字段使用$(...)运行时变量会失效，因为根级配置在流水线初始化阶段解析，此时资源流水线的变量还未加载完成。

可行解决方案 #

方案一：使用模板表达式直接在根级name中引用构建流水线运行名 #

利用Azure DevOps的模板表达式（$[xxx]）在流水线初始化阶段解析资源流水线的变量，直接设置发布名称。

调整后的YAML代码：

trigger:
  - none

resources:
  pipelines:
    - pipeline: build_pipeline
      source: Tool_build
      trigger:
        branches:
          - main
          - project_split

# 使用模板表达式$[]在初始化阶段解析资源流水线的运行名
name: Tool Deployment $[resources.pipeline.build_pipeline.runName]

stages:
  - stage: DeployToBeta
    jobs:
      - deployment: DeployJob
        environment: 'Beta'
        strategy:
          runOnce:
            deploy:
              steps:
                - script: echo "部署Beta环境，发布名称已关联构建流水线运行名"

  - stage: DeployToProduction
    dependsOn: DeployToBeta
    jobs:
      - deployment: DeployJob
        environment: 'Production'
        strategy:
          runOnce:
            deploy:
              steps:
                - script: echo "部署Production环境，发布名称已关联构建流水线运行名"

方案二：通过REST API更新流水线运行名（适用于复杂命名逻辑） #

如果需要自定义拼接发布名称（比如添加日期、版本后缀等），可以在流水线的第一个作业中调用Azure DevOps REST API更新流水线运行名，环境发布名会自动同步该名称。

示例代码（添加初始化作业）：

trigger:
  - none

resources:
  pipelines:
    - pipeline: build_pipeline
      source: Tool_build
      trigger:
        branches:
          - main
          - project_split

stages:
  - stage: InitializeReleaseName
    jobs:
      - job: UpdatePipelineName
        steps:
          - powershell: |
              $buildRunName = "$(resources.pipeline.build_pipeline.runName)"
              $newReleaseName = "Tool Deployment $(Get-Date -Format yyyMMdd)-$buildRunName"
              
              # 调用REST API更新流水线运行名
              $headers = @{
                Authorization = "Bearer $(System.AccessToken)"
              }
              $uri = "$(System.TeamFoundationCollectionUri)$(System.TeamProject)/_apis/build/builds/$(Build.BuildId)?api-version=7.1-preview.7"
              $body = @{
                buildNumber = $newReleaseName
              } | ConvertTo-Json
              
              Invoke-RestMethod -Uri $uri -Method Patch -Headers $headers -Body $body -ContentType "application/json"
            displayName: "更新流水线运行名（同步环境发布名）"

  - stage: DeployToBeta
    dependsOn: InitializeReleaseName
    jobs:
      - deployment: DeployJob
        environment: 'Beta'
        strategy:
          runOnce:
            deploy:
              steps:
                - script: echo "部署Beta环境"

  - stage: DeployToProduction
    dependsOn: DeployToBeta
    jobs:
      - deployment: DeployJob
        environment: 'Production'
        strategy:
          runOnce:
            deploy:
              steps:
                - script: echo "部署Production环境"

关键说明 #

• 模板表达式$[resources.pipeline.build_pipeline.runName]仅能在根级name、变量定义等编译阶段生效的字段中使用，运行时步骤中仍需用$(...)。
• 使用REST API时，需确保流水线的服务账号拥有Edit build pipeline权限，并且启用了Allow scripts to access the OAuth token选项（在流水线编辑页面的「代理作业设置」中开启）。

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