容器镜像服务 ACR：Docker登录、推送和拉取失败常见问题

docker login失败

为什么docker login失败？

登录失败时，参考如下步骤进行排查。

• 您使用了阿里云账户的登录密码，而不是Registry的独立登录密码。Registry的登录密码是在容器镜像服务控制台上设置与修改的，操作步骤如下。

  1. 登录容器镜像服务控制台

  2. 在实例列表页面单击实例卡片，进入实例详情页。

  3. 在左侧导航栏选择实例管理 > 访问凭证。

  4. 在访问凭证页面，单击右上角的设置固定密码。

  5. 在设置固定密码对话框，设定Registry的登录密码，然后单击确定。

• 您使用了sudo进行登录。使用sudo时，系统第一个要求输入的密码是Linux的用户密码。您可能在这里输入了Registry的登录密码，导致登录操作失败。

  区分这个错误的方式很简单，Linux的用户密码大多允许尝试三次，错误时会提示try again。而Registry的登录密码错误一次之后就会退出，并返回以下错误。

  Error response from daemon: Get https://registry.cn-hangzhou.aliyuncs.com/v2/: unauthorized: authentication required                    

• 如果您使用的是RAM用户，请勿使用阿里云账号设置的密码登录镜像仓库，您需要在容器镜像控制台设置密码，然后使用该密码登录镜像仓库。具体操作，请参见配置访问凭证。

为什么docker login超时？

检查您的网络是否可以正常使用。如果您的网络不能正常使用，将无法访问到实例，从而会导致docker login超时。

docker pull失败

docker pull失败，报错提示Error: image xxx not found

报错提示Error: image xxx not found

下载失败时，请参考如下步骤进行排查。

• 如果您是从公共仓库中下载镜像，那么问题可能是镜像地址不正确。

  请在容器镜像服务控制台搜索该公共仓库，检查确认想要下载的这个镜像版本是否真实存在。

• 如果您是从私有仓库中下载镜像，需要首先确认Registry的登录状态。

  1. 运行下边的命令，显示所有登录的Registry域名。

     cat ~/.docker/config.json                    

  2. 查看里面是否包含您想要下载镜像的Registry域名。

     如果没有的话，您需要先进行登录操作。

     如果显示已经登录的话，那么您需要确认您登录的这个账户是否有权限下载这个镜像。子账户默认没有任何权限。关于仓库的访问控制授权，请参见仓库访问控制。

  说明

  少数情况下会出现如下报错，下载的块文件检验失败。一般重试即可解决。

  报错提示：Error: filesystem layer verification failed for digest

为什么在企业版实例匿名拉取镜像会失败？

您需要在概览页面右侧实例设置区域打开公开匿名拉取，您才可以匿名拉取镜像。

docker push失败

docker push失败，报错提示denied: requested access to the resource is denied

上传失败时，主要的排查步骤和docker pull基本一致，只是授权要求的级别比docker pull更高。

为什么docker push会失败？

推送镜像之前请确保镜像已创建镜像仓库。如果没有镜像仓库，请确保命名空间已开启自动创建仓库功能。