如何让Azure Pipeline模板读取外部仓库自身文件？

默认情况下，Azure Pipeline只会检出调用模板的仓库，所以要让外部仓库里的模板读取自身仓库内的文件，必须主动在模板里添加检出自身仓库的步骤。

具体实现 #

• 在你的模板YAML中加入checkout步骤，明确指定模板所在仓库的地址与分支：

  steps:
    # 主动检出模板所在的外部仓库
    - checkout: git://YourOrg/YourTemplateRepo@main
      persistCredentials: true
      path: 'template-repo'  # 自定义检出路径，避免和主仓库文件混淆
  
    # 示例：读取模板仓库内的配置文件
    - script: |
        cat $(Build.SourcesDirectory)/template-repo/config/app-settings.yml
      displayName: '读取模板仓库内的文件'
  

• 私有仓库权限配置：
  如果模板仓库是私有的，需确保执行Pipeline的服务主体（或项目级权限）拥有该仓库的读取权限，优先通过Azure DevOps权限管理配置，避免硬编码凭据。

关键提示 #

• 必须指定path参数，防止两个仓库的文件路径冲突，确保能精准定位模板仓库的文件
• 若模板会被多个Pipeline调用，可将检出步骤单独封装为复用模板片段，减少重复代码
• 使用Azure Repos时，也可用仓库GUID替代YourOrg/YourTemplateRepo，格式为checkout: <仓库GUID>@<分支名>

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