如何引用Azure Pipeline矩阵策略Job的输出变量？

问题背景 #

在Azure Pipeline配置中，第一个Job通过matrix策略生成多平台构建任务，第三个message_teamsJob需要引用这些矩阵Job的输出变量，但尝试多种引用方式均无法获取值，仅能正常拿到第二个常规Job的输出变量。针对矩阵条目linux的Job，运行以下命令：

echo $(Agent.JobName)
echo $(System.JobName)
echo $(System.JobDisplayName)

得到结果：

Build linux
linux
Build linux

但尝试的多种引用方式均无效：

$[ dependencies.Build.outputs['SetJobStatus.x64linuxStatus'] ]
$[ dependencies.linux.outputs['SetJobStatus.x64linuxStatus'] ]
$[ dependencies.Build_linux.outputs['SetJobStatus.x64linuxStatus'] ]
$[ dependencies['Build linux'].outputs['SetJobStatus.x64linuxStatus'] ]

解决方案 #

1. 正确引用矩阵Job的依赖标识 #

矩阵中的每个Job在dependencies对象里的唯一标识是matrix定义的键名（即linux、win64、macOS_x64、macOS_arm64），而非显示名称或组合名称。

2. 修复输出变量设置脚本 #

原脚本中存在无效的变量设置命令（缺少##前缀且转义错误），导致变量未被正确输出。需保留标准格式的命令，移除无效行：

- bash: |
    echo $(Agent.JobName)
    echo $(System.JobName)
    echo $(System.JobDisplayName)
    # 仅保留正确的变量设置命令
    echo "##vso[task.setvariable variable=$(tripletCompressed)Status;isOutput=true]${AGENT_JOBSTATUS}"
  name: SetJobStatus
  displayName: Set Job Status Variable

3. 添加存在性判断（可选） #

若部分平台构建可能通过参数跳过，需使用exists函数避免引用不存在的依赖导致任务失败：

variables:
  windowsStatus: $[ if(exists(dependencies.win64)) { dependencies.win64.outputs['SetJobStatus.x64windowsStatus'] } else { 'Skipped' } ]
  linuxStatus: $[ if(exists(dependencies.linux)) { dependencies.linux.outputs['SetJobStatus.x64linuxStatus'] } else { 'Skipped' } ]
  macosIntelStatus: $[ if(exists(dependencies.macOS_x64)) { dependencies.macOS_x64.outputs['SetJobStatus.x64osxStatus'] } else { 'Skipped' } ]
  macosArmStatus: $[ if(exists(dependencies.macOS_arm64)) { dependencies.macOS_arm64.outputs['SetJobStatus.arm64osxStatus'] } else { 'Skipped' } ]
  universalStatus: $[ dependencies.create_universal_macos_binary.outputs['SetJobStatus.universalStatus'] ]

关键说明 #

• 矩阵Job的依赖引用必须使用matrix配置中的键名，而非Job显示名称或组合名称。
• 变量设置命令必须以##vso开头，否则Azure Pipeline无法识别并输出变量。
• 存在性判断可避免因部分平台构建被跳过，导致依赖不存在而引发的任务错误。

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