如何在Azure YAML中向模板参数正确传递变量以实现模板多次复用

问题根因 #

1. 复用的dockerbuild.yml模板未显式声明接收PATH参数，导致传入的参数没有被模板正确接收，仅能读取到流水线全局的PATH变量，因此首次调用正常，后续传入的PATH1、PATH2无法匹配全局变量名，直接输出未解析的变量标记。
2. 模板内使用$(PATH)属于运行时变量语法，优先读取流水线全局变量/系统环境变量，不会优先匹配传入的模板参数。
3. 原主流水线配置中jobs下直接嵌套steps不符合Azure DevOps Pipeline语法规范，可能引发配置解析异常。

修复步骤 #

1. 修正dockerbuild.yml模板

首先显式声明接收参数，使用模板参数语法引用传入的值，同时建议避免和系统内置的PATH环境变量重名，防止冲突：

# dockerbuild.yml
parameters:
  - name: DOCKER_PATH # 建议重命名避免和系统PATH环境变量冲突
    type: string
    default: ''

steps:
  - task: Bash@3
    displayName: Build an image to container registry
    inputs:
      script : echo ${{ parameters.DOCKER_PATH }}

2. 修正主流水线配置

补全job层级，传参对应修改为调整后的参数名：

# azurepipeline1.yml
resources:
  repositories:
  - repository: templates
    type: git
    name: components/pipeline_templates
trigger:
- none

pool:
  name: PoolA

variables:
- template: variabletemplates/var.build.yml@templates

jobs:
- job: BatchBuildImages
  steps:
      - template: CI-CD/dockerbuild.yml@templates
        parameters:
          DOCKER_PATH: ${{ variables.PATH }}
      - template: CI-CD/dockerbuild.yml@templates
        parameters:
          DOCKER_PATH: ${{ variables.PATH1 }}
      - template: CI-CD/dockerbuild.yml@templates
        parameters:
          DOCKER_PATH: ${{ variables.PATH2 }}

可选优化 #

如果需要批量调用模板，可使用循环语法减少重复代码，后续新增路径变量无需额外修改步骤配置：

steps:
  - ${{ each pathVar in variables }}:
    - ${{ if startsWith(pathVar.name, 'PATH') }}:
      - template: CI-CD/dockerbuild.yml@templates
        parameters:
          DOCKER_PATH: ${{ pathVar.value }}

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