Azure DevOps模板无法解析PowerShell输出变量问题排查

Azure DevOps模板在流水线初始化/编译阶段就会完成参数解析和作业生成，而$(filteredWebsitesPath)是运行时（PreDeployJob执行后）才生成的变量。模板编译时这个变量还没有实际值，因此会被当作字面量传递，导致后续的拆分逻辑完全失效。

要让模板能拿到运行时生成的变量值，需要把变量提升到阶段级别，并使用模板表达式语法（${{ ... }}）传递参数，确保模板编译时能获取到实际值。

修改后的流水线配置 #

trigger:
- main

pool:
  vmImage: 'windows-latest'

stages:

- stage: Build
  displayName: 'Build Stage'
  jobs:
  - job: BuildJob
    steps:
      - task: Npm@1
      - task: Npm@1
      - task: PublishBuildArtifacts@1
        inputs:
          PathtoPublish: 'build'
          ArtifactName: 'drop'


- stage: Deploy
  displayName: 'Deploy to Production'
  dependsOn: Build
  condition: succeeded()
  # 定义阶段级变量，直接从PreDeployJob获取输出值
  variables:
    filteredWebsitesPath: $[ dependencies.PreDeployJob.outputs['PreDeployJob.GetWebsites.filteredWebsitesNew'] ]

  jobs:
  - deployment: PreDeployJob
    displayName: 'PreDeployJob'
    environment: 
      name: 'Production'
      resourceType: VirtualMachine

    strategy:
      runOnce:
        deploy:
          steps:
          - task: PowerShellOnTargetMachines@3
            displayName: 'Get Website Names'
            name: GetWebsites
            inputs:
              Machines: 'ip:port'
              InlineScript: |
                  $websites = Get-ChildItem -Directory -Path 'C:\myPath\' | Select-Object -ExpandProperty Name
                  $filteredWebsites = $websites -join ','
                  Write-Host "##vso[task.setvariable variable=filteredWebsitesNew;isOutput=true]$filteredWebsites"
          - script: echo "Output: $(GetWebsites.filteredWebsitesNew)"
            name: echovar

  - job: SetVariableJob
    displayName: "Set Variable for Template"
    dependsOn: PreDeployJob
    steps:
    - script: echo "Filtered Websites Path $(filteredWebsitesPath)"      

  # 用模板表达式传递阶段变量给模板，确保编译时解析实际值
  - template: templates/deploy-template.yml
    parameters:
      filteredWebsitesNew: ${{ variables.filteredWebsitesPath }}

修改后的模板文件（deploy-template.yml） #

parameters:
  filteredWebsitesNew: ''

jobs:
# 加空值判断，避免无网站时生成空作业
- ${{ if ne(parameters.filteredWebsitesNew, '') }}:
  - ${{ each website in split(parameters.filteredWebsitesNew, ',') }}:
    # 给部署作业名称加唯一后缀，避免名称冲突
    - deployment: DeployJob_${{ replace(website, ' ', '_') }}
      displayName: 'Deploy to ${{ website }}'
      environment: 
        name: 'Production'
        resourceType: VirtualMachine
      strategy:
        runOnce:
          deploy:
            steps:
            - script: echo "Deploying to website ${{ website }}"
            # 直接用模板变量拼接路径，确保是实际值
            - script: echo "Folder Path: C:\myPath\${{ website }}\images"

关键改动说明 #

1. 阶段级变量定义：在Deploy阶段直接定义filteredWebsitesPath，通过$[ dependencies.PreDeployJob.outputs['...'] ]获取PreDeployJob的输出值，让变量在整个阶段内可用。
2. 模板参数传递语法：用${{ variables.filteredWebsitesPath }}替代$(filteredWebsitesPath)，模板表达式会在编译阶段解析变量的实际值，而非保留字面量。
3. 模板内防御性处理：添加空值判断避免生成无效作业，同时给部署作业名称加唯一后缀，防止因网站名称含空格导致的命名冲突。
4. 路径拼接修正：模板内直接使用${{ website }}拼接路径，彻底解决变量字面量问题。

• 查看PowerShellOnTargetMachines@3的任务日志，确认Write-Host输出的filteredWebsitesNew是正确的网站列表。
• 检查阶段变量的依赖路径是否匹配：dependencies.PreDeployJob.outputs['PreDeployJob.GetWebsites.filteredWebsitesNew']中，PreDeployJob是部署作业名，GetWebsites是PowerShell任务名，必须和流水线配置完全一致。

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