如何将Azure Pipeline UI设置的变量用作作业名称或displayName

作业名称无法使用UI变量的解决思路 #

Azure Pipeline的作业名称是编译阶段确定的，只有编译时能解析的变量才能用在这里。你之前尝试的方法失败，核心原因是UI设置的变量大概率是运行时注入的，编译阶段无法获取到值。

可行的解决方法：

• 将UI变量设置为编译时可用的管道变量：在Pipeline的「Variables」设置里，把该变量勾选为「Let users override this value when running this pipeline」（允许运行时覆盖），此时变量会在编译阶段被解析，直接用- job: ${{ variables.myVariable }}即可生效。你的变量格式Hello123符合作业名称规则（无特殊字符、空格、句点），可以正常使用。
• 用模板参数传递作业名称：如果需要更灵活的场景，可以定义作业模板并通过参数传递名称，示例：

  # 作业模板 job-template.yml
  parameters:
    jobName: ''
  jobs:
    - job: ${{ parameters.jobName }}
      steps:
        - script: echo "Running job ${{ parameters.jobName }}"
  
  # 主管道
  variables:
    myVariable: Hello123 # 或UI设置的编译时变量
  jobs:
    - template: job-template.yml
      parameters:
        jobName: ${{ variables.myVariable }}
  

displayName不显示变量的解决方法 #

displayName默认在编译阶段确定，$(OSName)属于运行时变量，编译阶段还未赋值，因此会被空值替换，只显示AAA BBB。解决方法分两种：

• 如果OSName是编译时变量：直接替换为编译时表达式displayName: "AAA ${{ variables.OSName }} BBB"，即可正常显示变量值。
• 如果OSName是运行时变量（比如脚本输出的）：只能通过Azure DevOps REST API在脚本中动态更新作业的displayName，示例PowerShell脚本：

  $token = "$(System.AccessToken)"
  $orgUrl = "$(System.CollectionUri)"
  $projectName = "$(System.TeamProject)"
  $buildId = "$(System.BuildId)"
  $jobId = "$(System.JobId)"
  
  $headers = @{
      Authorization = "Bearer $token"
      "Content-Type" = "application/json"
  }
  
  $body = @{
      name = "AAA $(OSName) BBB"
  } | ConvertTo-Json
  
  Invoke-RestMethod -Method Patch -Uri "$orgUrl/$projectName/_apis/build/builds/$buildId/timeline/$jobId?api-version=7.1-preview.1" -Headers $headers -Body $body
  

  注意需要给管道的服务账号授予「编辑构建管道」的权限。

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