Azure Pipeline多次检出同一仓库报错，寻求合规解决方案

问题背景 #

我被这个问题困扰多日，环境配置如下：

• 主Azure Pipeline包含10-15个可选择运行的阶段；
• 所有阶段都依赖一个执行任务并设置变量的PowerShell阶段；
• 除PowerShell阶段外，每个阶段都会调用模板，这些模板又会调用一个大型模板（部分阶段可能调用同一个或不同的大型模板）；
• 问题出在Checkout步骤：

- checkout: git://Project/${{parameters.RepositoryToCheckOut}}@$(Build.SourceBranch)
  path: PathSpecified

分支和仓库变量需要动态设置。当选择两个或更多阶段运行时，该步骤会执行多次，导致Azure DevOps报错：

An error occurred while loading the YAML build pipeline. An item with the same key has already been added.

我知道这是键值重复的问题，但不知道怎么解决。不想用简单的bash步骤手动检出，因为这些文件至关重要，不能出错。试过用参数和编译时变量，都没用，还是报同样的错，求可行解决方案。

可行解决方案 #

方案1：将Checkout移至依赖阶段，共享工作区 #

既然所有阶段都依赖那个PowerShell阶段，直接把Checkout步骤放到该阶段的作业里，通过工作区共享让其他阶段复用已检出的代码：

1. 修改PowerShell阶段的作业，添加Checkout并配置工作区保留：

stages:
- stage: Setup
  jobs:
  - job: SetupJob
    workspace:
      clean: outputs # 只清理输出目录，保留已检出的源码
    steps:
    - checkout: git://Project/${{parameters.RepositoryToCheckOut}}@$(Build.SourceBranch)
      path: PathSpecified
    - powershell: |
        # 这里写你的变量设置逻辑
      name: SetPipelineVariables

2. 在其他依赖阶段的作业中，配置继承Setup阶段的工作区：

- stage: StageA
  dependsOn: Setup
  jobs:
  - job: StageAJob
    workspace:
      inherit:
        from: SetupJob # 直接复用Setup阶段已检出的代码，无需重复执行Checkout
    steps:
    - template: your-stage-template.yml # 调用模板，模板里不用再写Checkout步骤

方案2：用条件判断控制Checkout仅执行一次 #

在大型模板里给Checkout步骤加条件，只有当还没检出过时才执行，同时标记已完成检出：

1. 在主Pipeline里定义一个全局变量：

variables:
  - name: IsRepoCheckedOut
    value: false

2. 修改大型模板中的Checkout步骤，添加条件和标记逻辑：

steps:
- checkout: git://Project/${{parameters.RepositoryToCheckOut}}@$(Build.SourceBranch)
  path: PathSpecified
  condition: eq(variables.IsRepoCheckedOut, 'false')
- script: echo "##vso[task.setvariable variable=IsRepoCheckedOut;isOutput=true]true"
  name: MarkCheckoutDone
  condition: eq(variables.IsRepoCheckedOut, 'false')

3. 在后续阶段中，引用前一阶段输出的标记变量，避免重复执行：

- stage: StageB
  dependsOn: [Setup, StageA]
  variables:
    IsRepoCheckedOut: $[stageDependencies.StageA.StageAJob.outputs['MarkCheckoutDone.IsRepoCheckedOut']]
  jobs:
  - job: StageBJob
    steps:
    - template: your-large-template.yml

方案3：通过仓库资源定义动态检出 #

在Pipeline顶部统一定义仓库资源，用参数动态指定仓库和分支，这样即使多阶段调用，也只会生成唯一的键：

1. 在Pipeline开头添加资源定义：

resources:
  repositories:
  - repository: TargetRepository
    type: git
    name: Project/${{parameters.RepositoryToCheckOut}}
    ref: $(Build.SourceBranch)

2. 在模板的Checkout步骤中引用这个预定义的资源：

- checkout: TargetRepository
  path: PathSpecified

这种方式下，仓库资源只会被定义一次，不会出现键重复的冲突。

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