Azure DevOps YAML跨阶段传多变量，实现组件按需部署

一、多阶段间传递多个变量值（构建→部署） #

使用Azure DevOps的**输出变量（Output Variables）**结合阶段依赖，就能在构建、部署两个阶段间传递任意数量的变量。核心是在构建阶段标记变量为输出变量，部署阶段通过stageDependencies引用。

实现步骤： #

1. 构建阶段设置输出变量：
   在检测可用组件并完成推送的任务中，用##vso[task.setvariable]命令设置输出变量，可以是单个组件列表，也可以是每个组件的可用状态。

   示例（PowerShell脚本）：

   # 检测3个组件的Zip文件是否存在于共享路径
   $components = @("ComponentA", "ComponentB", "ComponentC")
   $availableList = @()
   $componentAAvailable = "false"
   $componentBAvailable = "false"
   $componentCAvailable = "false"
   
   foreach ($comp in $components) {
     $zipPath = "$(sharedStoragePath)/$comp.zip"
     if (Test-Path $zipPath) {
       $availableList += $comp
       # 标记对应组件为可用
       Set-Variable -Name "component${comp}Available" -Value "true"
       # 执行推送至部署工具的逻辑
       Write-Host "Pushing $comp to deployment tool..."
       # 替换为实际推送命令，比如：
       # & deploy-tool push --component $comp --source $zipPath
     }
   }
   
   # 设置输出变量：传递可用组件列表
   Write-Host "##vso[task.setvariable variable=availableComponents;isOutput=true]$($availableList -join ',')"
   # 设置输出变量：单独传递每个组件的可用状态
   Write-Host "##vso[task.setvariable variable=componentAAvailable;isOutput=true]$componentAAvailable"
   Write-Host "##vso[task.setvariable variable=componentBAvailable;isOutput=true]$componentBAvailable"
   Write-Host "##vso[task.setvariable variable=componentCAvailable;isOutput=true]$componentCAvailable"
   

2. 部署阶段引用输出变量：
   部署阶段需通过dependsOn依赖构建阶段，然后在variables块中引用构建阶段的输出变量。引用格式为：$[ stageDependencies.<构建阶段名>.<构建作业名>.outputs['<任务名>.<变量名>'] ]

   示例：

   variables:
     # 引用可用组件列表
     availableComponents: $[ stageDependencies.build.detectPushJob.outputs['detectPushTask.availableComponents'] ]
     # 引用单个组件的可用状态
     componentAAvailable: $[ stageDependencies.build.detectPushJob.outputs['detectPushTask.componentAAvailable'] ]
   

二、仅部署已推送的组件 #

利用传递过来的可用组件列表，在部署阶段通过循环执行部署任务，只处理已标记为可用（已推送）的组件。有两种实现方式：

方式1：脚本循环部署 #

适合灵活处理复杂部署逻辑，用PowerShell/Bash循环遍历可用组件列表：

steps:
- task: PowerShell@2
  displayName: Deploy available components
  inputs:
    targetType: 'inline'
    script: |
      $components = "$(availableComponents)".Split(",") | Where-Object { $_ -ne "" }
      if ($components.Count -eq 0) {
        Write-Host "No components available to deploy."
        return
      }
      foreach ($comp in $components) {
        Write-Host "Starting deployment for $comp..."
        # 替换为实际部署命令
        # & deploy-tool deploy --component $comp --env $(deploymentEnv)
      }

方式2：YAML静态循环（推荐） #

如果使用Azure DevOps Server 2020及以上版本，可直接用YAML的each语法生成部署任务，更直观：

steps:
- ${{ each comp in split(variables.availableComponents, ',') }}:
  - task: CmdLine@2
    displayName: Deploy ${{ comp }}
    inputs:
      script: deploy-tool deploy --component ${{ comp }}
    # 过滤空值（当没有可用组件时）
    condition: ne('${{ comp }}', '')

完整YAML示例 #

stages:
- stage: build
  displayName: Detect & Push Components
  jobs:
  - job: detectPushJob
    displayName: Detect available components and push to deployment tool
    steps:
    - task: PowerShell@2
      name: detectPushTask
      inputs:
        targetType: 'inline'
        script: |
          $components = @("ComponentA", "ComponentB", "ComponentC")
          $availableList = @()
          foreach ($comp in $components) {
            $zipPath = "$(sharedStoragePath)/$comp.zip"
            # 这里替换为实际的共享位置文件检测逻辑，比如Azure文件共享需先挂载
            if (Test-Path $zipPath) {
              $availableList += $comp
              Write-Host "Pushing $comp to deployment tool..."
              # 替换为实际推送命令
              # & deploy-tool push --component $comp --source $zipPath
            }
          }
          $availableStr = $availableList -join ","
          Write-Host "##vso[task.setvariable variable=availableComponents;isOutput=true]$availableStr"

- stage: deploy
  displayName: Deploy Available Components
  dependsOn: build
  variables:
    availableComponents: $[ stageDependencies.build.detectPushJob.outputs['detectPushTask.availableComponents'] ]
  jobs:
  - job: deployJob
    displayName: Deploy only pushed components
    steps:
    - ${{ each comp in split(variables.availableComponents, ',') }}:
      - task: CmdLine@2
        displayName: Deploy ${{ comp }}
        inputs:
          script: deploy-tool deploy --component ${{ comp }}
        condition: ne('${{ comp }}', '')

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