推送镜像制品到镜像仓库

操作场景

推送镜像制品（推送也叫上传，镜像制品也叫镜像或者制品），可以帮助您将本地的镜像制品推送到容器镜像服务的制品仓库中，更方便的管理您的镜像制品。通过容器引擎客户端推送镜像制品到制品仓库。

容器引擎客户端上传镜像，是指在安装了容器引擎客户端的机器上使用Docker命令或者ctr命令将镜像上传到容器镜像服务的镜像仓库。如果是Docker容器引擎客户端则使用docker push命令上传。如果是containerd容器引擎客户端则使用ctr push命令上传。

容器引擎客户端推送镜像既可走内网链路也可走外网链路。详情请参见配置访问网络。

前提条件

使用镜像仓库前，您需要完成如下工作：

已经购买仓库并设置了仓库的访问权限，具体请参见访问控制概述。
已经创建访问凭证。

已创建命名空间，请参见创建命名空间。
已准备好容器引擎客户端，这台计算机已在访问控制中定义的公网或内网允许访问范围内。

约束与限制

使用Docker容器引擎客户端上传镜像时，需确保Docker容器引擎客户端版本必须为18.06及以上。
使用containerd容器引擎客户端上传镜像时，需确保containerd容器引擎客户端版本必须为1.5.0及以上。
镜像的每个layer层大小不能超过10G。
单个企业仓库实例上传镜像的并发个数最大为160个。

容器引擎客户端推送镜像

请参考下面的Docker容器引擎客户端和containerd容器引擎客户端的操作指导完成镜像的推送。

Docker容器引擎客户端

以root用户登录容器引擎客户端所在主机。
参考访问凭证获取临时或者长期访问凭证并在容器引擎客户端主机上执行登录上镜像仓库。
登录成功会显示“Login Succeeded”。

临时访问凭证生成后使用时效为24小时，超过使用时效需重新生成。长期凭证不会过期可一直使用。
执行以下命令为镜像打标签。
docker tag [镜像名称1:版本名称1] [镜像仓库地址]/[命名空间名称]/[镜像名称2:版本名称2]

其中：
- [镜像名称1:版本名称1]请替换为您所要上传的实际镜像的名称和版本名称。
- [镜像仓库地址]为仓库的访问地址，获取方式如下：
  登录容器镜像服务控制台，在页面左上角切换Region到您所在的Region，然后单击左侧菜单栏的“企业版”，在新打开的“仓库管理”页面，单击仓库名称进入仓库详情页面，在“总览-基本信息”页面获取访问地址。
- [命名空间名称]请替换为您在创建命名空间中创建的命名空间。
- [镜像名称2:版本名称2]请替换为您期待的镜像名称和版本名称。
上传镜像至镜像仓库。
docker push [镜像仓库地址]/[命名空间名称]/[镜像名称:版本名称]
在镜像详情页面镜像制品列表中可查看到对应的镜像制品信息。

镜像推送成功以后，您可以在CCE控制台创建工作负载。

containerd容器引擎客户端

登录容器镜像服务控制台。
单击左侧菜单栏的“企业版”，在新打开的“仓库管理”页面，单击仓库名称进入仓库详情页面。
单击左侧菜单栏的“镜像仓库””进入镜像仓库页面。单击您的镜像名称操作列的“快速指令”进入containerd页签。
在containerd页签，单击ctr -n k8s.io image tag后面的复制按钮复制打标签指令。
以root用户登录containerd引擎所在的主机，执行4复制的指令为您的镜像打上tag。请把命令中的参数替换为实际的值之后再执行。
ctr -n k8s.io image tag [镜像名称1:版本名称1] [镜像仓库地址]/[命名空间名称]/[镜像名称2:版本名称2]

其中：
- [镜像名称1:版本名称1]请替换为您所要上传的实际镜像的名称和版本名称。
- [镜像仓库地址]为仓库的访问地址，获取方式如下：
  登录容器镜像服务控制台，在页面左上角切换Region到您所在的Region，然后单击左侧菜单栏的“企业版”，在新打开的“仓库管理”页面，单击仓库名称进入仓库详情页面，在“总览-基本信息”页面获取访问地址。
- [命名空间名称]请替换为您在创建命名空间中创建的命名空间。
- [镜像名称2:版本名称2]请替换为您期待的镜像名称和版本名称。
在containerd页签，单击ctr -n k8s.io image push后面的复制按钮复制推送指令并修改版本名称为5中您所打的tag。

该指令将于24个小时后过期。若需要长期有效的上传指令，请参见访问凭证。
检查镜像是否推送成功。