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

工件缓存故障排除指南

在本教程中，你将排查使用工件缓存功能启用的注册表的最常见问题，具体方法是识别症状、原因并确定可能的解决方案以有效使用该功能。

症状和原因

可能包括以下一个或多个问题：

如果你遇到缓存的映像未显示在 Azure 容器注册表 (ACR) 的存储库中的问题，我们建议验证存储库路径。错误的存储库路径会导致缓存的映像不会显示在 ACR 的存储库中。

Azure 门户会自动填充这些字段。但是，许多 Docker 存储库的路径以 library/ 开头。例如，若要缓存 hello-world 存储库，正确的存储库路径为 docker.io/library/hello-world。

凭据是一组密钥保管库机密，以专用存储库的用户名和密码形式运行。凭据不正常的原因通常是这些机密不再有效。在 Azure 门户中，你可以选择凭据以编辑和应用更改。

若要分配对 Azure 密钥保管库的访问权限：

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

如果在创建缓存规则时遇到问题，建议验证是否创建了超过 1000 个缓存规则。

建议删除任何不需要的缓存规则，以避免达到限制。

详细了解缓存术语。

如果尝试创建缓存规则，但与现有规则存在冲突。错误消息显示，已存在具有指定目标存储库通配符的缓存规则。

要解决此问题，需要执行以下步骤：

工件缓存当前支持以下上游注册表：

警告

客户必须生成凭据集以从 Docker Hub 获取内容。