Azure DevOps Pipeline中ARM模板输出转变量的设置与访问问题

问题场景 #

我有一个用于部署ARM模板的Azure DevOps Pipeline模板，需要将ARM模板的输出（一个字符串数组）解析为流水线全程可访问的变量，但在设置和访问该变量时遇到问题：

1. 在Azure PowerShell脚本中，能正常获取并打印ARM模板的输出：

$outputJson = $deployment.outputs | ConvertTo-Json
Write-Host "print: $output"

执行后能看到完整的JSON输出，确认ARM模板的输出内容正常。

2. 尝试用以下代码设置流水线输出变量：

Write-Output "##vso[task.setvariable variable=outputTest;isOutput=true]$outputJson"

3. 但后续步骤中用多种语法访问变量，结果均为空：

Write-Host "print var test1: $outputTest"
Write-Host "print var test2: $(outputTest)"
Write-Host "print var test3: ${{ $variables.outputTest }}"
Write-Host "print var test4: '${{ $variables.outputTest }}'"

补充：流水线YAML结构如下：

steps:
  - script: |
      echo parameters.serviceconnection - ${{parameters.serviceconnection}}
      echo resourceGroup - ${{parameters.resourceGroup}}
      echo resourceGroupLocation - ${{parameters.resourceGroupLocation}}
      echo overrideParameters - ${{parameters.overrideParameters}}
    displayName: 'arm-template.yml - Variable list'

- task: AzurePowerShell@5
    displayName: "PowerShell template deploy"
    inputs:
      azureSubscription: ${{parameters.serviceConnection}}
      scriptType: InlineScript
      azurePowerShellVersion: LatestVersion
      inline: |
        # 我的ARM部署代码

解决思路 #

1. 修正任务输出变量的引用方式 #

使用isOutput=true设置的变量是任务级输出变量，不是全局变量，跨步骤引用必须指定任务的名称：

• 先给AzurePowerShell任务添加name属性：

- task: AzurePowerShell@5
    name: DeployArmTask # 新增任务名称
    displayName: "PowerShell template deploy"
    inputs:
      azureSubscription: ${{parameters.serviceConnection}}
      scriptType: InlineScript
      azurePowerShellVersion: LatestVersion
      inline: |
        # 我的ARM部署代码

• 后续步骤中正确引用：

Write-Host "print var: $(DeployArmTask.outputTest)"

2. 修复JSON输出格式问题 #

ARM模板的输出对象转JSON后可能包含换行、特殊字符，导致##vso命令解析失败，建议压缩为单行：

$outputJson = $deployment.outputs | ConvertTo-Json -Compress
Write-Host "##vso[task.setvariable variable=outputTest;isOutput=true]$outputJson"

另外检查原代码中的笔误：原打印代码用了$output但赋值的是$outputJson，确保传递给变量的是正确的内容。

3. 验证变量设置命令的执行状态 #

在设置变量的前后添加日志，确认命令确实被执行，且$outputJson不为空：

Write-Host "准备设置输出变量..."
$outputJson = $deployment.outputs | ConvertTo-Json -Compress
Write-Host "待设置的变量值：$outputJson"
Write-Host "##vso[task.setvariable variable=outputTest;isOutput=true]$outputJson"
Write-Host "输出变量设置完成"

4. 区分变量语法的适用场景 #

• $outputTest：仅在当前PowerShell脚本内部有效，无法跨步骤访问。
• $(outputTest)：运行时变量，同阶段内必须搭配任务名称使用，如$(DeployArmTask.outputTest)。
• ${{ $variables.outputTest }}：编译时变量，流水线启动前就会解析，而ARM模板输出是运行时生成的，完全不适用。

5. 确认ARM部署的有效性 #

检查AzurePowerShell任务的订阅、资源组配置是否正确，确保ARM部署成功完成，$deployment对象有效，避免因部署失败导致$deployment.outputs为空。

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