如何配置Renovate过滤ACR镜像前缀的Registry URL以匹配私有镜像？

安全阿岳

2026-6-22

解决Renovate Bot无法识别ACR私有镜像的问题

问题核心

你的docker-compose.yml中镜像写为<ACR_URL>/<TEAM>/prometheus:0.0.1，但ACR内的镜像实际名称是<TEAM>/prometheus。Renovate默认会把完整的<ACR_URL>/<TEAM>/prometheus当作包名去查询，导致匹配失败。

解决方案：修改renovate.json配置

通过packageRules调整包名识别规则，去掉ACR_URL前缀，让Renovate用正确的镜像名去ACR查询更新。

修改后的完整renovate.json

{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": [
    "config:base"
  ],
  "baseBranches": [
    "main"
  ],
  "hostRules": [
    {
      "matchHost": "$ACR_URL",
      "username": "$ACR_USER",
      "password": "$ACR_TOKEN"
    }
  ],
  "packageRules": [
    {
      "groupName": "all non-major dependencies",
      "groupSlug": "all-minor-patch",
      "matchPackagePatterns": [
        "*"
      ],
      "registryUrls": [
        "$ACR_URL"
      ]
    },
    {
      // 匹配带ACR_URL前缀的Docker镜像
      "matchDatasources": ["docker"],
      "matchPackageNames": ["<ACR_URL>/<TEAM>/*"],
      // 将包名替换为ACR内的实际名称（去掉ACR_URL前缀）
      "packageNameTemplate": "{{packageName | replace('<ACR_URL>/', '')}}",
      // 指定查询的私有仓库地址
      "registryUrls": ["$ACR_URL"]
    }
  ]
}

配置说明

matchPackageNames：精准匹配所有以<ACR_URL>/<TEAM>/开头的Docker镜像，确保只调整你的团队镜像。
packageNameTemplate：使用Renovate模板语法，去掉包名中的<ACR_URL>/前缀，让Renovate用<TEAM>/prometheus去ACR查询更新。
registryUrls：明确指定查询的私有ACR地址，配合hostRules中的认证信息，确保Renovate能访问私有仓库。