你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

排查 Azure 容器注册表中的工件缓存问题

了解如何通过识别症状、原因和潜在解决方案来解决通过项目缓存功能启用的注册表的最常见问题。

凭据不正常

凭据是一组 Azure Key Vault 机密,用作专用存储库的用户名和密码。 当这些机密不再有效时,可能会发生凭据不正常事件。 在 Azure 门户中,可以选择凭据以编辑和应用更改。

验证 Azure Key Vault 中的机密是否有效,以及是否分配了对 Azure Key Vault 的访问权限。

若要分配对 Azure Key Vault 的访问权限,请运行以下命令:

az keyvault set-policy --name myKeyVaultName --object-id myObjID --secret-permissions get

有关详细信息,请参阅 Key Vault 和分配对 Azure Key Vault 的访问权限

无法创建缓存规则

如果无法创建缓存规则,则可能已达到缓存规则限制,或者规则可能与现有规则冲突。

缓存规则限制问题

如果超过 1,000 个缓存规则的限制,则在创建缓存规则时可能会遇到问题。

如果达到此限制,请删除不再需要的任何缓存规则。

无法使用通配符创建缓存规则

如果尝试创建与现有规则冲突的缓存规则,则会看到一条错误消息,说明已存在具有指定目标存储库通配符的缓存规则。

若要解决此问题,请执行以下步骤:

  1. 确定导致冲突的现有缓存规则。 查找对目标存储库使用通配符(*)的现有规则。
  2. 删除与源存储库和通配符重叠的冲突缓存规则。
  3. 使用所需的通配符和目标存储库创建新的缓存规则。
  4. 仔细检查缓存配置,确保正确应用新规则,并且没有其他存在冲突的规则。

有关通配符和潜在冲突的详细信息,请参阅 Azure 容器注册表中项目缓存的通配符支持

支持的上游存储库

请确保上游存储库受支持。 有关详细信息,请参阅 上游支持

后续步骤

  • 了解如何使用通配符匹配容器映像注册表中的多个路径。
  • 详细了解工件缓存