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

排查 Azure 容器应用中的映像拉取失败

如果 Azure 无法从指定的注册表拉取容器映像，则无法创建或执行容器，从而导致启动应用程序失败。映像拉取失败是指 Azure 平台无法下载（描述为“拉取”）应用程序所需的容器映像。

原因

以下列表详细说明了映像拉取失败的可能原因：

映像名称或标记不正确：当配置中指定的映像名称或标记不正确或拼写错误时，会发生此错误。这些错误可能包括不正确的映像存储库名称、映像标记或映像版本。
身份验证问题（专用注册表）：如果映像存储在专用注册表（如 Azure 容器注册表）或专用 Docker Hub 注册表中，则需要确保提供适当的身份验证凭据来拉取映像。如果这些凭据缺失、不正确或已过期，则拉取操作将失败。
注册表不可用或网络问题：如果容器注册表关闭或无法访问（由于网络问题或配置错误），则拉取请求不会成功完成。此失败也可能源于 Azure 容器应用与注册表之间的 DNS 问题、防火墙或连接问题。出现网络问题时，映像无法从注册表拉取，导致容器创建失败。
超出速率限制或配额：许多容器注册表（包括 Docker Hub）对可以拉取映像的频率强制实施速率限制。如果超出速率限制或配额（例如，在短时间内拉取过多映像），则会暂时阻止映像拉取。当拉取被阻止时，容器不会启动，因为 Azure 容器应用无法检索阻止部署的映像。
找不到映像：如果映像不存在，或者指定了错误的标记或存储库，则可能会出现此失败。

容器应用诊断具有智能和交互式体验，可帮助排查应用故障，无需任何配置。使用以下步骤访问 Azure 容器应用诊断。