Azure DevOps Pipeline中对象数组输出变量传入模板参数的方法

错误原因解析 #

模板参数apps定义为object类型，要求编译阶段就能识别为序列/映射结构，但你用$(apps)传递的是运行时变量，在模板解析时它只是普通字符串，不符合参数类型要求，因此报错Expected a sequence or mapping. Actual value '$(apps)'。同时原初始化脚本输出的变量格式也不是合法的JSON数组，导致后续无法解析为对象。

修正步骤 #

1. 初始化阶段输出合法JSON数组 #

修改Bash脚本，将数组拼接成标准JSON字符串输出，确保变量是可解析的数组结构：

# applications-pipeline.yml 中 Initialize 阶段的脚本
script: |
  applications=(
    '{"application": "app1", "environments": ["dev", "test", "production"]}'
    '{"application": "app2", "environments": ["dev", "staging"]}'
  )
  # 将数组元素用逗号连接，包裹为JSON数组格式
  apps_json="[$(IFS=, ; echo "${applications[*]}")]"
  echo "##vso[task.setvariable variable=apps;isOutput=true]$apps_json"

同时给Initialize阶段的job添加名称，确保跨阶段变量引用正确：

- stage: Initialize
  displayName: Initialize
  jobs:
  - job: AppsList  # 添加job名称，用于后续变量引用
    steps:
    - task: Bash@3
      name: Applications
      inputs:
        # 其余配置不变

2. 跨阶段传递时使用编译时表达式 #

在ProcessApps阶段，用${{ variables.apps }}替代$(apps)传递给模板参数，让编译阶段能解析为对象：

# applications-pipeline.yml 中 ProcessApps 阶段
variables: 
  - name: apps
    value: $[ stageDependencies.Initialize.AppsList.outputs['Applications.apps'] ]
jobs:    
  - template: templates/process-apps-template.yml
    parameters:
      apps: ${{ variables.apps }}  # 使用编译时表达式

3. 模板中动态设置作业名称和显示名 #

在模板循环中，通过${{ app.application }}拼接作业名称和显示名称：

# templates/process-apps-template.yml
parameters:
- name: apps
  type: object
  default: []

jobs:
- job: PaceholderJob
  steps:
  - script: echo "Placeholder job"

- ${{ each app in parameters.apps }}:
  - job: ProcApp_${{ app.application }}
    displayName: Process Application - ${{ app.application }}
    steps:
      - task: Bash@3
        inputs:
          targetType: inline
          script: |
            echo ${{ app.application }}

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