如何在Azure YAML Pipeline中用环境文件循环调用任务模板

一、环境参数文件定义 #

每个环境的参数文件（如envA.yml、envB.yml）统一用数组格式存储多组任务参数，每组包含PowerShell模板需要的3个必填参数：

# envA.yml
parameters:
  # 存储当前环境下所有任务参数组，支持3-5组
  taskParameters:
    - param1: "EnvA_Task1_P1"
      param2: "EnvA_Task1_P2"
      param3: "EnvA_Task1_P3"
    - param1: "EnvA_Task2_P1"
      param2: "EnvA_Task2_P2"
      param3: "EnvA_Task2_P3"
    - param1: "EnvA_Task3_P1"
      param2: "EnvA_Task3_P2"
      param3: "EnvA_Task3_P3"

envB.yml沿用完全相同的结构，仅替换为对应环境的参数值即可。

二、主作业模板实现 #

创建主模板（如deploy-by-environment.yml），通过两层循环实现环境遍历和任务调用：

# deploy-by-environment.yml
parameters:
  # 必填：指定要部署的目标环境列表（字符串数组）
  - name: environments
    type: string[]
    required: true
  # 可选：传递给所有任务的通用参数
  - name: globalCommonParam
    type: string
    default: ""

jobs:
  # 第一层循环：遍历每个目标环境
  - ${{ each env in parameters.environments }}:
    - job: Deploy_To_${{ env }}
      displayName: "Deploy to ${{ env }}"
      steps:
        # 加载当前环境的参数文件，获取任务参数组数组
        - template: ${{ env }}.yml
          name: Load_${{ env }}_Params
          parameters:
            commonParam: ${{ parameters.globalCommonParam }}

        # 第二层循环：遍历当前环境下的所有任务参数组
        - ${{ each taskSet in steps.Load_${{ env }}_Params.outputs['taskParameters'] }}:
            - template: your-powershell-task-template.yml
              displayName: "Run Task ${{ each.index + 1 }} for ${{ env }}"
              parameters:
                param1: ${{ taskSet.param1 }}
                param2: ${{ taskSet.param2 }}
                param3: ${{ taskSet.param3 }}
                # 可选：传递环境名到任务模板，用于日志或逻辑区分
                environment: ${{ env }}

三、PowerShell任务模板适配（可选） #

如果需要在任务模板中区分环境，可添加可选参数：

# your-powershell-task-template.yml
parameters:
  - name: param1
    type: string
    required: true
  - name: param2
    type: string
    required: true
  - name: param3
    type: string
    required: true
  - name: environment
    type: string
    required: false

steps:
- task: PowerShell@2
  displayName: "PS Task [${{ parameters.environment }}]"
  inputs:
    targetType: filePath
    filePath: ./your-script.ps1
    arguments: >
      -Param1 "${{ parameters.param1 }}"
      -Param2 "${{ parameters.param2 }}"
      -Param3 "${{ parameters.param3 }}"
      -Environment "${{ parameters.environment }}"

四、流水线调用示例 #

在主流水线文件中指定目标环境，调用主模板即可：

# azure-pipelines.yml
trigger:
  branches:
    include: [ main ]

extends:
  template: deploy-by-environment.yml
  parameters:
    environments: ["envA", "envB"]
    globalCommonParam: "prod-config"

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