拉取镜像到本地

操作场景

您可以使用docker容器引擎也可以使用containerd容器引擎下载容器镜像服务中的镜像。

前提条件

• 在下载镜像前，请确保您的网络畅通。详细网络配置步骤请参考配置访问网络。
• 在下载镜像前，请联系管理员在IAM控制台授权容器镜像服务下载权限，详情请参考权限管理。
• “我的镜像”展示当前用户所有的自有镜像（该用户所在组织所拥有的镜像）和共享镜像（该组织下其他用户共享的私有镜像）。
• IAM用户创建后，需要管理员在组织中为您添加授权，您才具有该组织内镜像的读取、编辑等权限。详情请参考授权管理。

下载“我的镜像”

您可以使用docker容器引擎也可以使用containerd容器引擎下载容器镜像服务中的镜像。

• docker容器引擎

1. 以root用户登录容器引擎所在的虚拟机。
2. 参考2获取登录访问权限，连接容器镜像服务。
3. 登录容器镜像服务控制台。
4. 在左侧导航栏选择“我的镜像”，单击右侧镜像名称。
5. 在镜像详情页面中，单击对应镜像版本“下载指令”列的复制图标，复制镜像下载指令。
   图1 获取镜像下载指令
   

6. 在虚拟机中执行5复制的镜像下载指令。

   示例：docker pull swr.cn-east-3.myhuaweicloud.com/group/nginx:v2.0.0

   使用docker images命令查看是否下载成功。

   # docker images
   REPOSITORY                                                              TAG       IMAGE ID       CREATED         SIZE
   swr.cn-east-3.myhuaweicloud.com/group/nginx                             v2.0.0    22f2bf2e2b4f   5 hours ago     22.8MB

7. （可选）执行如下命令将镜像保存为归档文件。

   docker save [镜像名称:版本名称] > [归档文件名称]

   示例：docker save swr.cn-east-3.myhuaweicloud.com/group/nginx:v2.0.0 > nginx.tar

• containerd容器引擎

1. 登录容器镜像服务控制台。
2. 在左侧导航栏选择“我的镜像”，单击右侧镜像名称。
3. 在镜像详情页面中，复制操作列的“containerd指令”或者进入“Pull/Push指南”页签，复制containerd容器引擎的镜像下载指令。
   

   该指令将于6个小时后过期。若需要长期有效的下载指令，请参见获取containerd容器引擎长期有效的拉取、推送镜像指令。

4. 以root用户登录containerd引擎所在的虚拟机。
5. 在虚拟机中执行3复制的镜像下载指令。
   • 复制操作列的“containerd指令”的场景下执行：

     

   • 复制“Pull/Push指南”页签containerd容器下载指令的场景下执行：

     

6. 查看镜像是否下载成功。
   • 复制操作列的“containerd指令”的场景下使用circtl images 命令查看是否下载成功。

     

   • 复制“Pull/Push指南”页签containerd容器下载指令的场景下使用ctr images list命令查看是否下载成功。

     

下载镜像中心的镜像

镜像中心的镜像可直接下载，无需添加仓库地址。如图2所示的mongo镜像，只需容器引擎所在虚拟机连接SWR，且执行如下命令即可将其下载。

docker pull mongo:4.1

图2 mongo镜像详情示例