Azure DevOps YAML中${{ each }}循环无法解析跨阶段输出变量

问题重现 #

在Azure DevOps YAML管道中，尝试用${{ each }}循环处理跨阶段传递的输出变量时出现异常：

• 直接用$(varlist)可以正确显示value1,value2
• 但${{ cert }}输出的却是变量定义的字面字符串$[stageDependencies.StageA.mso.outputs['bla.varlist']]

相关YAML代码：

stages:
  - stage: StageA
    displayName: "Stage A"
    pool: DefaultPool
    jobs:
      - job: StageA
        steps:
          - checkout: self
          - task: PowerShell@2
            name: bla
            displayName: "Set Vars"
            inputs:
              targetType: "inline"
              script: |
                Write-Host "##vso[task.setvariable variable=varlist;isOutput=true]value1,value2"

  - stage: Deploy
    displayName: "Deploy"
    dependsOn: StageA
    variables:
      varlist: $[stageDependencies.StageA.outputs['bla.varlist']]
    jobs:
      - deployment: "Deploy"
        environment:
          name: "Production"
          resourceType: VirtualMachine
          tags: APP
        strategy:
          rolling:
            maxParallel: 100
            deploy:
              steps:
                - checkout: self
                - task: PowerShell@2
                  displayName: "give output"
                  inputs:
                    targetType: "inline"
                    script: |
                      Write-Host "Var output $(varlist)"
                - ${{ each cert in split(variables.varlist, ',')}}:
                  - task: PowerShell@2
                    displayName: "import ${{ cert }}"
                    inputs:
                      targetType: "inline"
                      script: |
                        Write-Host "Cert ${{ cert }}"
                        Write-Host "varlist $(varlist)"

日志输出：

Cert $[stageDependencies.StageA.mso.outputs['bla.varlist']]
varlist value1,value2

原因分析 #

核心问题是Azure DevOps表达式的求值时机差异：

1. ${{ }}属于编译时表达式：管道在开始执行前就会解析所有${{ }}语法的内容，此时跨阶段传递的varlist还只是一个未被替换的表达式字符串$[stageDependencies.StageA.outputs['bla.varlist']]，而非运行时才会生成的value1,value2。
2. $(varlist)和$[ ]属于运行时表达式/变量：在任务执行阶段才会替换为实际的变量值，因此能正确输出value1,value2。

因为编译时variables.varlist的内容是无逗号的表达式字符串，split(variables.varlist, ',')只会得到一个包含该表达式的数组，循环输出自然就是表达式字面量。

解决方案 #

由于YAML的${{ each }}无法处理运行时动态生成的变量值，推荐两种可行方案：

方案1：在PowerShell任务内循环处理（简单直接） #

将循环逻辑移到单个PowerShell任务中，利用运行时变量值进行循环：

- task: PowerShell@2
  displayName: "Process each certificate"
  inputs:
    targetType: "inline"
    script: |
      # 拆分运行时获取的变量值
      $certList = "$(varlist)".Split(',')
      
      foreach ($cert in $certList) {
        Write-Host "Processing cert: $cert"
        # 在这里添加每个证书的处理逻辑，比如导入证书、执行脚本等
        # 示例：& .\Import-Cert.ps1 -CertName $cert
      }

方案2：使用动态模板扩展（适合需要独立任务的场景） #

如果必须为每个证书创建独立任务，可以通过运行时生成任务定义结合模板实现：

1. 创建一个模板文件（如cert-deploy-template.yml）：

parameters:
  - name: certName
    type: string

steps:
  - task: PowerShell@2
    displayName: "import ${{ parameters.certName }}"
    inputs:
      targetType: "inline"
      script: |
        Write-Host "Cert ${{ parameters.certName }}"
        Write-Host "varlist $(varlist)"

2. 在Deploy阶段的PowerShell任务中生成动态任务调用：

- task: PowerShell@2
  displayName: "Generate cert deployment tasks"
  inputs:
    targetType: "inline"
    script: |
      $certs = "$(varlist)".Split(',')
      $templateContent = @"
      steps:
"@
      foreach ($cert in $certs) {
        $templateContent += @"
        - template: cert-deploy-template.yml
          parameters:
            certName: '$cert'
"@
      }
      # 将生成的YAML写入临时文件
      $templateContent | Out-File -FilePath $(Build.SourcesDirectory)/dynamic-tasks.yml -Encoding utf8
  - checkout: self # 确保临时文件被识别
  - template: dynamic-tasks.yml # 引用动态生成的模板

注意：方案2需要确保临时文件能被管道识别，可能需要调整checkout步骤或文件路径。

验证说明 #

修改后，运行管道时：

• PowerShell任务会在运行时获取到varlist的实际值value1,value2
• 循环处理每个证书时，能正确输出value1和value2，而非表达式字面量

内容的提问来源于stack exchange，提问作者Peter the Automator