如何在YAML流水线中传递PowerShell函数输出至Bash脚本

问题背景 #

需要实现流水线逻辑：

1. 用PowerShell函数检查指定路径下的包是否有变更（基于git diff的退出码）
2. 在Bash任务中获取该结果，后续用YAML条件判断决定是否跳过构建

当前代码传递输出的方式报错，以下是修正方案：

1. 修正PowerShell检查脚本 #

原函数中有无效代码，简化后直接输出字符串格式的结果（方便Bash捕获）：

function packageChangeChecker {
    param(
        [Parameter(Mandatory = $true)]
        [string] $pathToPackage    
    )
    # 执行git diff，静默检查指定路径变更，屏蔽错误输出
    git diff HEAD~:src/$pathToPackage HEAD:src/$pathToPackage --exit-code --quiet 2>/dev/null
    # 根据git退出码输出对应结果
    if ($LastExitCode -eq 1) {
        Write-Output "true"  # 存在变更
    }
    else {
        Write-Output "false" # 无变更
    }
}

# 接收命令行参数并执行函数
packageChangeChecker $args[0]

2. 修正Bash任务：捕获输出并设置流水线变量 #

必须通过Azure DevOps的任务命令将结果设置为输出变量，才能让后续阶段引用：

- task: Bash@3
  displayName: 'detectChanges'
  name: detectChanges # 必须设置name，用于后续引用输出
  inputs:
    targetType: 'inline'
    script: |
        pathToPackage="docker-dotnet-app-aks2/"
        # 调用PowerShell脚本并捕获输出
        filesChanged=$(powershell.exe -Command "& { . .\package-change-checker.ps1; packageChangeChecker '$pathToPackage' }")
        # 将结果设置为流水线输出变量
        echo "##vso[task.setvariable variable=filesChanged;isOutput=true]$filesChanged"

注意：如果使用Linux代理，将powershell.exe替换为pwsh

3. 修正YAML条件判断 #

确保引用路径正确（阶段名→作业名→任务名→变量名），且语法完整：

# 假设检查逻辑所在阶段为preBuildChecks，作业名为checkChanges
- ${{ if eq(stageDependencies.preBuildChecks.checkChanges.outputs['detectChanges.filesChanged'], 'true') }}:
  - task: YourBuildTask@X
    displayName: '构建变更的包'
    inputs:
      # 构建任务参数

关键注意事项 #

• 确保代理机器上git可用，且仓库已拉取足够历史（HEAD~存在，否则git diff会失败）
• PowerShell脚本避免多余输出（如git警告），可通过2>/dev/null屏蔽错误输出
• 输出变量必须标记isOutput=true，否则无法跨阶段引用

内容的提问来源于stack exchange，提问作者DevOps-AS