操作场景

客户端上传镜像，是指在安装了容器引擎客户端的机器上使用docker命令将镜像上传到容器镜像服务的镜像仓库。

如果容器引擎客户端机器为云上的ECS或CCE节点，根据机器所在区域有两种网络链路可以选择：

若机器与容器镜像仓库在同一区域，则上传镜像走内网链路。 若机器与容器镜像仓库不在同一区域，则上传镜像走公网链路，机器需要绑定弹性公网IP。

约束与限制

使用客户端上传镜像，镜像的每个layer大小不能超过10G。 上传镜像的容器引擎客户端版本必须为1.11.2及以上。

前提条件

已创建组织，请参见创建组织。

操作步骤

制作容器镜像或导入镜像文件。

连接容器镜像服务。

1. 登录容器镜像服务控制台。
2. 选择左侧导航栏的“总览”，单击页面右上角的“登录指令”，在弹出的页面中单击复制登录指令。

说明：此处生成的登录指令有效期为24小时，若需要长期有效的登录指令，请参见获取长期有效登录指令。获取了长期有效的登录指令后，在有效期内的临时登录指令仍然可以使用。

1. 在安装容器引擎的机器中执行上一步复制的登录指令。登录成功会显示“Login Succeeded”。

在安装容器引擎的机器上执行如下命令，为nginx镜像打标签。

docker tag [镜像名称1:版本名称1] [镜像仓库地址]/[组织名称]/[镜像名称2:版本名称2]

其中：

[镜像名称1:版本名称1]：请替换为您所要上传的实际镜像的名称和版本名称。

1. [镜像仓库地址]：可在SWR控制台上查询，即2.b中登录指令末尾的域名。
2. [组织名称]：请替换为您创建的组织。
3. [镜像名称2:版本名称2]：请替换为您期待的镜像名称和镜像版本。

示例：

docker tag nginx:v1 swr.cn-east-3.myhuaweicloud.com/cloud-develop/nginx:v1

上传镜像至镜像仓库。

docker push [镜像仓库地址]/[组织名称]/[镜像名称2:版本名称2]

示例：

docker push swr.cn-east-3.myhuaweicloud.com/cloud-develop/nginx:v1

终端显示如下信息，表明上传镜像成功。

The push refers to repository [swr.cn-east-3.myhuaweicloud.com/cloud-develop/nginx:v1]

fbce26647e70: Pushed

fb04ab8effa8: Pushed

8f736d52032f: Pushed

009f1d338b57: Pushed

678bbd796838: Pushed

d1279c519351: Pushed

f68ef921efae: Pushed

v1: digest: sha256:0cdfc7910db531bfa7726de4c19ec556bc9190aad9bd3de93787e8bce3385f8d size: 1780

返回容器镜像服务控制台，在“我的镜像”页面，执行刷新操作后可查看到对应的镜像信息。

约束与限制

每次最多上传10个文件，单个文件大小（含解压后）不得超过2G。

仅支持上传1.11.2及以上容器引擎客户端版本制作的镜像压缩包。

前提条件

已创建组织，请参见创建组织。

镜像已保存为tar或tar.gz文件，具体请参见制作镜像压缩包。

操作步骤

登录容器镜像服务控制台。

在左侧导航栏选择“我的镜像”，单击右上角“页面上传”。

在弹出的窗口中选择组织，单击“选择镜像文件”，选择要上传的镜像文件。

说明：多个镜像同时上传时，镜像文件会按照顺序逐个上传，不支持并发上传。

单击“开始上传”。

待任务进度显示“上传完成”，表示镜像上传成功。

操作场景

您可以使用docker pull命令下载容器镜像服务中的镜像。

前提条件

在下载镜像前，请确保您的网络畅通。详细网络配置步骤请参考配置访问网络。

在下载镜像前，请联系管理员在IAM控制台授权容器镜像服务下载权限，详情请参考权限管理。

“我的镜像”展示当前用户所有的自有镜像（该用户所在组织所拥有的镜像）和共享镜像（该组织下其他用户共享的私有镜像）。

IAM用户创建后，需要管理员在组织中为您添加授权，您才具有该组织内镜像的读取、编辑等权限。详情请参考授权管理

下载“我的镜像”

以root用户登录容器引擎所在的虚拟机。

参考2获取登录访问权限，连接容器镜像服务。

登录容器镜像服务控制台。

在左侧导航栏选择“我的镜像”，单击右侧镜像名称。

在虚拟机中执行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

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

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

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

如何制作镜像压缩包？

镜像上传下载咨询

为什么登录指令执行失败？

为什么使用客户端上传镜像失败？