Azure DevOps Pipeline重复调用YAML模板时参数值未更新问题

问题场景 #

在Azure DevOps Pipeline中，核心模板repo.yml通过PowerShell的Invoke-Command连接$(Server)指定的机器。需要两次调用该模板，分别传入ClientServer和AppServer参数值，但第二次调用时$(Server)始终保留第一次的ClientServer值，尝试each循环遍历参数也未生效。全局变量$(LogInUser)和$(LogInPassword)可正常使用。

相关代码如下：

repo.yml

steps:
- powershell: |
     $SecurePass = ConvertTo-SecureString -AsPlainText $(LogInPassword) -Force
     $Cred = New-Object System.Management.Automation.PSCredential -ArgumentList $(LogInUser),$SecurePass 
     Write-Output $(Server)
     $Result = Invoke-Command  -ComputerName $(Server) -Credential $Cred -ScriptBlock 

参数模板

parameters:
  AppServer: 'a'
  ClientServer: 'b'
jobs:
- job: Deploy
  variables:
    ClientServer: ${{ parameters.ClientServer }}
    AppServer: ${{ parameters.AppServer }}
  pool:
   name: pool
  workspace:
   clean: all
  timeoutInMinutes: 120
  steps:
  - template: ../main.yml

main.yml

steps:
  - template: Install.yml

Install.yml

steps:
- template: repo.yml@templates
  parameters:
    Server: ${{ parameters.ClientServer }}
- template: repo.yml@templates
  parameters:
    Server: ${{ parameters.AppServer }}

尝试的循环写法

- ${{ each Server in parameters.Servers }}:
  - template: repo.yml@templates
    parameters:
      Server: ${{ Server }}

问题原因 #

1. repo.yml未定义模板参数，直接使用运行时变量$(Server)，导致重复调用时变量值未被正确覆盖（运行时变量在Job周期内保持初始值）。
2. Install.yml调用模板时错误引用了未定义的自身参数${{ parameters.ClientServer }}，而非Job级变量。
3. 循环写法中缺少数组参数的定义与传递链路，导致遍历逻辑无有效数据源。

解决方案 #

方案1：修正直接调用的参数传递逻辑

1. 更新repo.yml，添加模板参数定义
   改用编译阶段模板表达式${{ parameters.Server }}引用参数，避免运行时变量污染：

   parameters:
     - name: Server
       type: string
       default: ''
   
   steps:
   - powershell: |
        $SecurePass = ConvertTo-SecureString -AsPlainText $(LogInPassword) -Force
        $Cred = New-Object System.Management.Automation.PSCredential -ArgumentList $(LogInUser),$SecurePass 
        Write-Output "${{ parameters.Server }}"
        $Result = Invoke-Command -ComputerName "${{ parameters.Server }}" -Credential $Cred -ScriptBlock {
            # 填入你的目标执行逻辑
        }
   

2. 修正Install.yml的参数来源
   直接引用Job级变量，而非未定义的自身参数：

   steps:
   - template: repo.yml@templates
     parameters:
       Server: ${{ variables.ClientServer }}
   - template: repo.yml@templates
     parameters:
       Server: ${{ variables.AppServer }}
   

方案2：使用each循环批量调用模板（适合扩展多服务器场景）

1. 修改参数模板，添加数组参数

   parameters:
     AppServer: 'a'
     ClientServer: 'b'
   
   jobs:
   - job: Deploy
     variables:
       ClientServer: ${{ parameters.ClientServer }}
       AppServer: ${{ parameters.AppServer }}
       # 构建服务器列表数组
       ServerList: [ '${{ parameters.ClientServer }}', '${{ parameters.AppServer }}' ]
     pool:
      name: pool
     workspace:
      clean: all
     timeoutInMinutes: 120
     steps:
     - template: ../main.yml
       parameters:
         Servers: ${{ variables.ServerList }}
   

2. 更新main.yml，传递数组参数

   parameters:
     - name: Servers
       type: object
       default: []
   
   steps:
     - template: Install.yml
       parameters:
         Servers: ${{ parameters.Servers }}
   

3. 修改Install.yml实现循环调用

   parameters:
     - name: Servers
       type: object
       default: []
   
   steps:
   - ${{ each server in parameters.Servers }}:
     - template: repo.yml@templates
       parameters:
         Server: ${{ server }}
   

4. 确保repo.yml已添加参数定义（同方案1的修改）

关键注意点 #

• 模板内必须使用${{ parameters.xxx }}编译阶段语法引用参数，避免运行时变量$(xxx)导致的参数污染。
• 调用模板时，明确参数来源是上级模板参数还是Job级变量，避免引用未定义的参数。
• 循环遍历前，需确保数组参数在整个模板链路中正确传递。

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