Azure DevOps Pipeline中CopyFiles@2任务条件执行失败求助

问题场景 #

用户的Azure DevOps流水线中，希望CopyFiles@2任务仅在PowerShell任务执行成功且检测到notebooks目录有文件变更时运行，但当前该任务总是被跳过；若将条件改为or，任务会执行但报错。

原流水线代码 #

trigger:
  branches:
    include:
      - 'main'

variables:
  - group: dbw-cicd-dev
  
  - name: vmImageName
    value: "windows-latest"
  - name: notebooksPath
    value: "notebooks"
  - name: notebooksFolder
    value: false

pool:
  vmImage: $(vmImageName)

stages:
  - stage: ChangedFolder
    displayName: "Checking the Notebooks folder changes"
    jobs:
      - job: preCheck
        displayName: "Copy_Notebooks"
        steps:
          - checkout: self
            fetchDepth: 2

          - powershell: |
              $files=$(git diff HEAD HEAD~ --name-only)
              $temp=$files -split ' '
              $count=$temp.Length
              echo "Total number of changed files: $count"
              For ($i=0; $i -lt $count; $i++)
              {
                $name=$temp[$i]
                echo "Changed file is: $name"
                if ($name -like 'notebooks/*')
                {
                  $flag = 'True'
                  echo "Is it a notebooks change: $flag"
                  Write-Host "##vso[task.setvariable variable=notebooksFolder;isOutput=true]True"
                }
              }
              ##echo ${{variables.notebooksPath}}
              if (($flag -eq 'True'))
              {
                ## Now create a temp folder to hold the changed files
                New-Item -ItemType directory -Path $(system.defaultworkingdirectory)\temp

                foreach($file in $temp)
                {
                  if(Test-Path -path $file)
                  {
                    Copy-Item -Path $file -Destination $(system.defaultworkingdirectory)\temp
                    echo "File Moved: $file"
                  }
                }
              }              
            name: taskVariable

          - task: CopyFiles@2
            inputs:
              SourceFolder: '$(system.defaultworkingdirectory)\temp'
              Contents: '*.py'
              TargetFolder: '$(Build.ArtifactStagingDirectory)/notebooks'
              CleanTargetFolder: true
            condition: and(succeeded(), eq(variables.notebooksFolder, True))

  - stage: DeployNotebooks
    displayName: "Deploy to DEV Environment"
    dependsOn: ChangedFolder
    condition: |
      and( 
        succeeded('ChangedFolder'),
        eq(dependencies.changedFolder.outputs['precheck.taskVariable.notebooksFolder'], 'True')
      )
    jobs:
      - job: Deploy_Notebooks
        steps:
          - template: templates/deploy-notebooks.yml
            parameters:              
              environmentName: $(dev-environment-name)
              resourceGroupName: $(dev-resource-group-name)
              serviceConnection: $(dev-service-connection-name)
              notebooksPath: $(notebooksPath)

问题排查与修复 #

1. 输出变量引用方式错误 #

PowerShell任务中设置的notebooksFolder是输出变量（通过isOutput=true标记），但原CopyFiles任务的条件直接引用了全局变量variables.notebooksFolder，其初始值为false，导致条件始终不满足。

修复方式：在同一个job内，输出变量需要通过任务名称.变量名的方式引用，修改CopyFiles任务的条件：

- task: CopyFiles@2
  inputs:
    SourceFolder: '$(system.defaultworkingdirectory)\temp'
    Contents: '*.py'
    TargetFolder: '$(Build.ArtifactStagingDirectory)/notebooks'
    CleanTargetFolder: true
  condition: and(succeeded(), eq(taskVariable.notebooksFolder, 'True'))

2. PowerShell变量初始化缺失 #

原PowerShell代码中$flag变量未初始化，当没有notebooks目录的文件变更时，$flag会是null，导致后续创建临时目录的逻辑可能异常，也会影响输出变量的准确性。

修复方式：在PowerShell脚本开头初始化$flag为False，并添加文件夹创建的-Force参数避免重复创建报错：

$flag = 'False' # 初始化默认值
$files=$(git diff HEAD HEAD~ --name-only)
$temp=$files -split ' '
$count=$temp.Length
echo "Total number of changed files: $count"
For ($i=0; $i -lt $count; $i++)
{
  $name=$temp[$i]
  echo "Changed file is: $name"
  if ($name -like 'notebooks/*')
  {
    $flag = 'True'
    echo "Is it a notebooks change: $flag"
    Write-Host "##vso[task.setvariable variable=notebooksFolder;isOutput=true]True"
  }
}
##echo ${{variables.notebooksPath}}
if (($flag -eq 'True'))
{
  ## Now create a temp folder to hold the changed files
  New-Item -ItemType directory -Path $(system.defaultworkingdirectory)\temp -Force

  foreach($file in $temp)
  {
    if(Test-Path -path $file)
    {
      Copy-Item -Path $file -Destination $(system.defaultworkingdirectory)\temp -Recurse # 支持子文件夹复制
      echo "File Moved: $file"
    }
  }
}

3. Deploy阶段变量引用大小写不一致 #

原Deploy阶段的条件中，job名称写成了precheck（小写c），但实际job名称是preCheck（驼峰），会导致无法正确获取输出变量。

修复方式：修正job名称的大小写：

condition: |
  and( 
    succeeded('ChangedFolder'),
    eq(dependencies.ChangedFolder.outputs['preCheck.taskVariable.notebooksFolder'], 'True')
  )

总结 #

通过修正输出变量的引用方式、初始化PowerShell变量、统一名称大小写，即可让CopyFiles@2任务在符合条件时正常执行，同时避免不必要的报错。

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