如何配置Renovate基于GitHub标签跨私有仓库更新依赖？

需求：让Renovate扫描私有仓库A的YAML文件，以另一个私有GitHub仓库B的标签作为数据源，自动更新YAML中的指定值。两个仓库均为私有且已安装Renovate。

仓库A：renovate-test #

仓库内YAML文件内容：

ref: refs/tags/exampleTag/1.0.0

仓库B：renovate-test-tags #

仓库包含标签：exampleTag/1.0.0

当前配置与报错 #

当前Renovate配置中添加了以下内容：

"regexManagers": [
  {
    "fileMatch": [".*y[a]?ml$"],
    "matchStrings": ["refs\\/tags\\/(?<depName>.*)\\/(?<currentValue>.*)"],
    "datasourceTemplate": "github-tags"
  }
]

出现的错误日志：

DEBUG: Datasource unknown error
{
  "datasource": "github-tags",
  "packageName": "exampleTag",
  "err": {
    "message": "Variable $name of type String! was provided invalid value",
    "stack": "Error: Variable $name of type String! was provided invalid value"
  }
}

以及依赖解析警告：

{
  "baseBranch": "main",
  "config": {
    "regex": [
      {
        "deps": [
          {
            "depName": "exampleTag",
            "currentValue": "1.0.0",
            "datasource": "github-tags",
            "replaceString": "refs/tags/exampleTag/1.0.0",
            "updates": [],
            "warnings": [
              {
                "topic": "exampleTag",
                "message": "Failed to look up github-tags dependency exampleTag"
              }
            ],
            "versioning": "semver"
          }
        ],
        "matchStrings": ["refs/tags/(?<depName>.*)/(?<currentValue>.*)"],
        "datasourceTemplate": "github-tags",
        "packageFile": "pipeline.yml"
      }
    ]
  }
}

疑问：是否需要指定registryUrlTemplate指向标签仓库，例如https://github.com/<org_name>/renovate-test-tags？

问题根源 #

github-tags数据源要求depName必须是GitHub仓库的完整路径（格式为组织名/仓库名），而当前配置中匹配出的depName是exampleTag（标签前缀），并非仓库路径，导致Renovate无法识别要访问的目标仓库，因此报错。

正确配置方案 #

方案一：固定指定目标仓库 #

直接在配置中指定仓库B的完整路径，同时自定义版本匹配规则以适配带前缀的标签：

"regexManagers": [
  {
    "fileMatch": [".*y[a]?ml$"],
    "matchStrings": [
      "refs/tags/(?<currentValue>exampleTag/.*)"
    ],
    "depNameTemplate": "<org_name>/renovate-test-tags",
    "datasourceTemplate": "github-tags",
    "versioningTemplate": "regex:^exampleTag/(?<version>.*)$"
  }
]

方案二：动态适配标签前缀（多场景复用） #

如果需要支持多个类似前缀的标签，可调整匹配逻辑，同时保留版本提取规则：

"regexManagers": [
  {
    "fileMatch": [".*y[a]?ml$"],
    "matchStrings": [
      "refs/tags/(?<tagPrefix>[^/]+)/(?<currentValue>[^/]+)"
    ],
    "depNameTemplate": "<org_name>/renovate-test-tags",
    "datasourceTemplate": "github-tags",
    "versioningTemplate": "regex:^(?<tagPrefix>[^/]+)/(?<version>[^/]+)$",
    "replaceStringTemplate": "refs/tags/{{tagPrefix}}/{{newValue}}"
  }
]

关键注意事项 #

1. 仓库路径必填：github-tags数据源依赖depName的组织名/仓库名格式定位仓库，必须正确填写仓库B的完整路径。
2. 版本规则适配：由于标签包含前缀exampleTag/，需用自定义regex版本规则提取实际版本号，否则Renovate无法识别版本更新。
3. 权限验证：确保Renovate使用的GitHub Token拥有访问仓库A和仓库B的权限，否则会出现私有仓库访问失败的问题。
4. 无需registryUrlTemplate：github-tags数据源不需要指定registryUrlTemplate，只需通过depName指定仓库路径即可。

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