如何在Azure DevOps YAML流水线中访问ARM部署任务的deploymentOutputs

问题背景 #

我正在开发YAML流水线，基于Azure DevOps仓库中的main.bicep文件部署HUB资源（目前仅部署Azure ADF），部署可正常完成，但需要获取Bicep部署的输出（例如已部署Azure资源的ID）。

现有流水线代码 #

stages:
  #  DEPLOYING INFRASTRUCTURE - HUB
  - stage: DeployHub
    displayName: Deploy Hub Infrastructure
    jobs:
      - deployment: DeployHub
        displayName: Deploy Hub Infrastructure
        environment: '$(testEnvironment)' # 用于手动审批条件
        strategy:
          runOnce:
            deploy:
              steps:
                # 拉取代码，后续可用于git diff检查提交修改的文件
                - checkout: git://${{ variables.my_org }}/my_project@refs/heads/feature_branch_01

                # 实际部署HUB资源
                - task: AzureResourceManagerTemplateDeployment@3
                  name: ARM_Template_Deployment_HUB
                  displayName: 'Bicep Deployment Task HUB'
                  inputs:
                    deploymentScope: 'Resource Group'
                    azureResourceManagerConnection: '$(serviceConnection)'
                    action: 'Create Or Update Resource Group'
                    resourceGroupName: '$(rgTesting)'
                    location: 'some_location'
                    templateLocation: 'Linked artifact'
                    csmFile: '$(Build.SourcesDirectory)/$(bicepFilePathHUB_Test)'
                    deploymentMode: Incremental
                    deploymentOutputs: 'armOutputsHUB'

疑问点 #

• 如何访问armOutputsHUB？
• 在同一Job或Stage内访问是否有影响？
• 它存储在哪里？我了解部署作业使用$(Pipeline.Workspace)系统变量，但未找到armOutputsHUB变量。

已尝试的无效方法 #

在同一Job中添加了后续PowerShell任务，但未成功获取输出：

- task: PowerShell@2
  displayName: 'Parse ARM deploymentOutputs'
  env:
    ARM_OUTPUTS: $(armOutputsHUB)
  inputs:
    targetType: 'inline'
    errorActionPreference: continue
    workingDirectory: '$(Pipeline.Workspace)' # 默认是"$(Build.SourcesDirectory)"
    pwsh: true
    script: |
      Write-Host "armOutputsHUB = $armOutputsHUB" # 无输出
      Write-Host "armOutputsHUB = $($armOutputsHUB)" # 无输出
      Write-Host "armOutputsHUB = $($ARM_Template_Deployment_HUB.armOutputsHUB)" # 无输出

      $outputsObject = $env:ARM_OUTPUTS | ConvertFrom-Json
      # 错误: Conversion from JSON failed with error: Unexpected character encountered while parsing value: $. Path '', line 0, position 0.
      Write-Host "outputsObject = $($outputsObject)"  # 无输出
      Write-Host "outputsObject = $outputsObject"  # 无输出

可行解决方案 #

核心原理 #

AzureResourceManagerTemplateDeployment@3任务的deploymentOutputs参数会将部署输出存储为当前任务绑定的运行时变量，必须通过任务名称前缀来访问，格式为$(<TaskName>.<DeploymentOutputsName>)。

修正后的解析任务代码 #

- task: PowerShell@2
  displayName: 'Parse ARM deploymentOutputs'
  inputs:
    targetType: 'inline'
    pwsh: true
    script: |
      # 直接通过任务名称+输出变量名访问部署输出
      $rawArmOutputs = '$(ARM_Template_Deployment_HUB.armOutputsHUB)'
      Write-Host "原始部署输出内容: $rawArmOutputs"

      # 将JSON字符串转换为PowerShell对象（Depth参数确保嵌套结构能被正确解析）
      $outputsObject = $rawArmOutputs | ConvertFrom-Json -Depth 10
      Write-Host "解析后的输出对象: $($outputsObject | ConvertTo-Json -Depth 10)"

      # 示例：获取Bicep中定义的具体输出（假设你在Bicep里定义了名为adfResourceId的输出）
      if ($outputsObject.PSObject.Properties['adfResourceId']) {
          $adfResourceId = $outputsObject.adfResourceId.value
          Write-Host "Azure ADF资源ID: $adfResourceId"

          # 可选：将输出设置为流水线变量，供后续任务直接使用
          Write-Host "##vso[task.setvariable variable=ADFResourceId;]$adfResourceId"
      }

针对疑问的解答 #

1. 访问方式：必须通过$(<部署任务名称>.<deploymentOutputs参数值>)格式引用，比如示例中的$(ARM_Template_Deployment_HUB.armOutputsHUB)。
2. 同一Job/Stage访问影响：同一Job内直接按上述格式引用即可，只要解析任务在部署任务之后执行；同一Stage的不同Job需要将输出设置为输出变量（添加isOutput=true），再通过依赖引用。
3. 存储位置：部署输出不是文件，而是存储在流水线的运行时任务上下文变量中，不会出现在$(Pipeline.Workspace)目录下，只能通过任务绑定的变量名访问。

内容的提问来源于stack exchange，提问作者M. Pheles