Azure DevOps中使用uses语句访问多仓库的正确方式

一、「Repository is not found」权限问题排查 #

1. 检查服务主体/PAT权限：Renovate使用的服务主体或个人访问令牌（PAT），得对所有目标仓库拥有读取权限，还要具备仓库贡献者权限（用于创建PR），别只给第一个仓库配置权限。如果仓库分布在不同项目下，服务主体需要加入对应项目的「项目集合参与者」或「项目参与者」组，确保跨项目访问权限。
2. 核对仓库名称：别忽略拼写错误，比如仓库名的大小写、路径格式，要写完整的项目名/仓库名，别漏了项目前缀。

二、Azure DevOps流水线uses语句的正确用法 #

uses语句主要用来引用官方或自定义的流水线模板，在多仓库Renovate场景里，两种常见用法：

1. 引用官方Renovate模板 #

直接使用官方提供的Azure DevOps任务模板，格式如下：

steps:
- uses: renovatebot/azure-pipelines-renovate@v39.0.0
  with:
    configurationFile: '$(System.DefaultWorkingDirectory)/renovate.json'
    token: '$(MultiRepoRenovatePAT)'

注意：

• 必须指定具体的模板版本（比如@v39.0.0），别用latest，避免版本兼容问题。
• 这里的token不能用默认的$(System.AccessToken)——这个令牌仅拥有当前仓库的权限，多仓库场景下必须传入一个覆盖所有目标仓库权限的PAT，并且将该PAT设为流水线的保密变量。

2. 引用自定义多仓库模板 #

如果自己编写了多仓库处理模板（比如放在专门的模板仓库里），要先声明模板仓库，再引用：

resources:
  repositories:
  - repository: renovate-templates
    type: git
    name: DevOps-Templates/Renovate-MultiRepo
    ref: refs/tags/v1.0.0

jobs:
- job: run-renovate
  steps:
  - template: multi-repo-renovate.yml@renovate-templates
    parameters:
      targetRepos:
        - 'ProjectA/Repo1'
        - 'ProjectB/Repo2'
      patToken: '$(MultiRepoRenovatePAT)'

注意：

• 必须在resources.repositories里声明模板仓库的完整信息：仓库别名、类型、完整名称（项目名/仓库名）、引用的分支或标签版本。
• 引用模板时要加上仓库别名后缀，比如multi-repo-renovate.yml@renovate-templates。
• 自定义模板里要写好多仓库的遍历逻辑，比如用循环逐个调用Renovate任务，给每个仓库传入正确的名称和权限令牌。

三、多仓库场景容易遗漏的配置点 #

• PAT权限范围：用来运行Renovate的PAT必须勾选「Code (Full)」权限，而且要在组织级别创建，不能是单个仓库级别，这样才能覆盖所有目标仓库。
• Renovate配置文件：如果使用全局renovate.json，要确保repositories字段包含所有目标仓库，或者开启autodiscover: true并设置过滤规则，比如：

{
  "autodiscover": true,
  "autodiscoverFilter": ["ProjectA/*", "ProjectB/*"],
  "token": "{{process.env.RENOVATE_TOKEN}}"
}

• 流水线权限绑定：如果是定时触发的流水线，要确认流水线的权限设置允许访问所有目标仓库，别只绑定了第一个仓库。
• 模板仓库权限：如果使用自定义模板，运行流水线的服务主体得有读取模板仓库的权限，否则会拉取不到模板。

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