如何让Azure Pipeline手动构建选择指定Git分支

由于Azure Pipeline的resources段确实不支持直接引用构建变量，要实现手动触发时指定分支拉取目标仓库，可通过以下两种方案解决：

方案一：直接使用Checkout任务指定分支 #

跳过resources段的分支绑定，在管道的steps中通过checkout任务明确指定仓库和分支，直接引用BUILD_SOURCEBRANCHNAME变量：

resources:
  repositories:
    - repository: Main
      type: git
      name: Software/Main
    - repository: SdkThirdParty
      type: git
      name: Software/SdkThirdParty
    - repository: SdkTestData
      type: git
      name: Software/SdkTestData

steps:
  # 拉取Main仓库时使用手动选择的分支
  - checkout: Main
    ref: 'refs/heads/$(BUILD_SOURCEBRANCHNAME)'
    persistCredentials: true # 若后续需操作仓库可保留，否则可移除

  # 其他仓库保持默认拉取master分支
  - checkout: SdkThirdParty
  - checkout: SdkTestData

方案二：用模板复用分支拉取逻辑 #

如果需要在多个管道中复用该逻辑，可将checkout逻辑封装为模板，通过参数传递分支名：

1. 创建模板文件templates/checkout-repo.yml：

parameters:
  - name: repoName
    type: string
  - name: branchName
    type: string

steps:
  - checkout: ${{ parameters.repoName }}
    ref: 'refs/heads/${{ parameters.branchName }}'
    persistCredentials: true

2. 在主管道中调用模板：

resources:
  repositories:
    - repository: Main
      type: git
      name: Software/Main
    - repository: SdkThirdParty
      type: git
      name: Software/SdkThirdParty
    - repository: SdkTestData
      type: git
      name: Software/SdkTestData

steps:
  # 拉取Main仓库使用指定分支
  - template: templates/checkout-repo.yml
    parameters:
      repoName: Main
      branchName: $(BUILD_SOURCEBRANCHNAME)

  # 其他仓库默认拉取master
  - checkout: SdkThirdParty
  - checkout: SdkTestData

注意事项 #

• 若触发管道的主仓库是Main，Azure默认会自动执行一次checkout，上述方案中的显式checkout会覆盖默认行为，确保拉取指定分支。
• 若需要多个仓库都使用手动选择的分支，只需为每个仓库添加对应的checkout步骤或模板调用即可。

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