Azure DevOps流水线：按相同分支或标签克隆多个仓库

问题根源 #

你遇到的标签触发报错，是因为误用了branch参数（该参数仅支持分支名，会自动拼接refs/heads/前缀），导致标签的完整引用路径被错误追加，形成refs/heads/refs/tags/xxx这种无效路径。

通用解决方案 #

使用ref参数替代branch，直接传入ADO预定义变量$(Build.SourceBranch)即可实现分支和标签场景通用——该变量本身已包含完整的合法引用路径（分支为refs/heads/xxx，标签为refs/tags/xxx）。

完整YAML示例 #

# 关闭自动触发，仅允许手动启动
trigger: none

# 声明其他需要克隆的仓库（可选，也可直接在checkout步骤中指定）
resources:
  repositories:
    - repository: repo002
      type: git
      name: 你的ADO项目名/repo-0002
    - repository: repo003
      type: git
      name: 你的ADO项目名/repo-0003

pool:
  vmImage: 'ubuntu-latest' # 根据需求替换为Windows或其他镜像

steps:
# 克隆流水线所在的repo-0001，确保拉取触发时的分支/标签
- checkout: self
  ref: $(Build.SourceBranch)
  persistCredentials: true # 若需后续操作仓库，可开启此选项

# 克隆repo-0002
- checkout: repo002
  ref: $(Build.SourceBranch)

# 克隆repo-0003
- checkout: repo003
  ref: $(Build.SourceBranch)

关键说明 #

• ref参数支持完整的Git引用路径，无论是分支还是标签的refs/前缀格式都能正确识别，不会额外拼接前缀。
• $(Build.SourceBranch)是ADO自动生成的预定义变量，手动触发时会自动获取你选择的分支或标签的完整引用路径，无需手动传递额外变量。
• 若不想通过resources声明仓库，也可直接在checkout步骤中用仓库URL指定，例如：

  - checkout: git://你的ADO项目名/repo-0002
    ref: $(Build.SourceBranch)
  

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