Azure DevOps Server YAML流水线各Job工作目录变更致任务失败排查

核心原因 #

1. 多仓库引用触发工作目录上下文切换 #

迁移后流水线同时引用了产品代码仓库FOO和独立的YAML模板仓库YAML-Automation：

• Build阶段的Job会显式检出FOO仓库代码到_work\1目录，完成构建；
• Test阶段的Job设置了checkout: none，阻止了任何仓库检出操作。Azure DevOps会为这种与Build阶段完全不同的检出上下文创建全新的工作目录（_work\2），该目录默认为空，导致测试任务因找不到文件失败。

2. Job间工作目录天然隔离 #

Azure DevOps中每个Job默认拥有独立的工作目录，即使运行在同一代理上。之前YAML与产品代码同仓时，所有Job默认检出同一仓库，因此复用_work\1；迁移后Test Job的检出配置与Build Job完全不同，触发了新工作目录的创建，且未继承任何代码或构建产物。

3. 未通过标准机制传递构建产物 #

Test阶段依赖Build阶段的输出，但当前未配置工件(Artifact)发布/下载流程，而是直接依赖工作目录共享——这在多Job/多阶段场景下完全不可靠，Job间工作目录相互隔离，无法直接访问彼此文件。

解决方案建议 #

方案1：显式检出产品仓库 #

修改jobTests-All.yml，移除checkout: none，改为显式检出FOO仓库，确保Test Job能获取到代码：

jobs:
- job: Run_all_unit_tests
  displayName: 'All Unit Tests'
  steps:
    - checkout: FOO  
    - template: /Jobs/${{ parameters.productName }}/jobTests-${{ parameters.productName }}-UnitTests.yml
      parameters:    
        configuration: Debug

方案2：使用工件传递构建产物（推荐） #

通过Azure DevOps的工件机制在阶段间传递构建产物，彻底摆脱对工作目录的依赖：

1. 在jobBuild-All.yml末尾添加发布工件步骤：

   - publish: $(Build.ArtifactStagingDirectory)/${{ parameters.productName }}
     artifact: ${{ parameters.productName }}-Debug
   

2. 在jobTests-All.yml中添加下载工件步骤：

   jobs:
   - job: Run_all_unit_tests
     displayName: 'All Unit Tests'
     steps:
       - checkout: none
       - download: current
         artifact: ${{ parameters.productName }}-Debug
       - template: /Jobs/${{ parameters.productName }}/jobTests-${{ parameters.productName }}-UnitTests.yml
         parameters:    
           configuration: Debug
           buildArtifactPath: $(Pipeline.Workspace)/${{ parameters.productName }}-Debug
   

   （需同步修改测试模板中的路径配置，指向下载的工件目录）

方案3：强制复用工作目录（临时方案） #

在Test Job中添加workspace配置，强制继承前一阶段的工作目录，但该方式依赖代理可用性，且并行Job可能引发冲突，仅适合临时验证：

jobs:
- job: Run_all_unit_tests
  displayName: 'All Unit Tests'
  workspace:
    clean: outputs
    inherit: true
  steps:
    - template: /Jobs/${{ parameters.productName }}/jobTests-${{ parameters.productName }}-UnitTests.yml
      parameters:    
        configuration: Debug

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