文档首页/ 容器镜像服务 SWR/ 用户指南（基础版）/ 镜像管理/ 推送镜像到镜像仓库
更新时间：2026-09-24 GMT+08:00
查看PDF
分享

推送镜像到镜像仓库

操作场景

推送镜像（也叫上传镜像），可以帮助您将本地的镜像推送到容器镜像服务的镜像仓库中，更方便地管理您的镜像。推送镜像到镜像仓库有两种方式：通过容器镜像引擎客户端推送镜像和通过SWR页面推送镜像。

  • 容器引擎客户端推送镜像：是指在安装了容器引擎客户端的机器上使用docker命令或者ctr命令将镜像推送到容器镜像服务的镜像仓库。适用于大镜像的上传。

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

  • SWR页面推送镜像：是指直接通过SWR控制台页面将镜像推送到容器镜像服务的镜像仓库。适用于小镜像的推送。

前提条件

  • 已创建组织，请参见创建组织。
  • 已准备好容器引擎客户端。
  • 使用页面推送镜像时请确保镜像已保存为tar或tar.gz文件，具体请参见制作镜像压缩包。

约束与限制

  • 使用docker容器引擎客户端推送镜像时，需确保docker容器引擎客户端必须为18.06及以上的版本；
  • 镜像的每个layer大小不能超过50G；
  • 单个租户同时并发推送镜像layer总数不大于20个。
  • 页面推送镜像每次最多上传10个文件，单个文件大小（含解压后）不得超过2G。且仅支持推送18.06及以上的版本Docker容器引擎客户端制作的镜像压缩包。
  • 不支持推送Open Container Initiative（OCI）规范（v1.0 和 v1.1）的镜像。可使用企业版SWR进行推送。
  • 单个租户可推送的镜像配额为500个，镜像版本配额为300个。超过配额将会推送失败。

推送镜像到镜像仓库

  • 小镜像可以使用页面推送镜像，暂不支持断点续传。大镜像推荐使用客户端推送。
  • SWR对存储的镜像数量有配额限制，请及时老化不再使用的镜像。
docker容器引擎客户端
  1. 登录SWR控制台。
  2. 选择左侧导航栏的“总览”，单击页面右上角的“登录指令”，在弹出的页面中单击复制登录指令。

    • 临时登录指令支持用户自定义临时登录有效时间，支持设置有效期是15分钟-24小时。若需要长期有效的登录指令，请参见获取长期有效的登录或推拉镜像指令。获取了长期有效的登录指令后，在有效期内的临时登录指令仍然可以使用。
    • 登录指令末尾的域名为镜像仓库地址，请记录该地址，后面会使用到。
  3. 在安装容器引擎的机器中执行上一步复制的登录指令。

    登录成功会显示“Login Succeeded”。

  4. 在安装容器引擎的机器上执行如下命令，为nginx镜像打标签。 
    docker tag [镜像名称1:版本名称1] [镜像仓库地址]/[组织名称]/[镜像名称2:版本名称2]
其中，
    • [镜像名称1:版本名称1]：请替换为您所要推送的实际镜像的名称和版本名称。
    • [镜像仓库地址]：可在SWR控制台上查询，即2.b中登录指令末尾的域名。
    • [组织名称]：请替换为您创建的组织。
    • [镜像名称2:版本名称2]：请替换为您期待的镜像名称和镜像版本。
    示例： 
    docker tag nginx:v1 swr.cn-east-3.myhuaweicloud.com/cloud-develop/nginx:v1
  5. 推送镜像至镜像仓库。 
    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
  6. 返回容器镜像服务控制台，在“我的镜像”页面，执行刷新操作后可查看到对应的镜像信息。

Containerd容器引擎客户端

  1. 登录SWR控制台。
  2. 在左侧导航栏选择“我的镜像”，单击右侧镜像名称。
  3. 在镜像详情页面中，进入“Pull/Push指南”页签，复制Containerd容器引擎的镜像推送指令。

    临时登录指令支持用户自定义临时登录有效时间，支持设置有效期是15分钟-24小时。若需要长期有效的推送指令，请参见获取Containerd容器引擎通用型登录指令之长期有效的拉取、推送镜像指令。

  4. 以root用户登录Containerd容器引擎所在的虚拟机。在虚拟机上执行如下命令，为镜像打标签。 
    ctr -n k8s.io images tag {镜像名称1}:{版本名称1} {镜像仓库地址}/{组织名称}/{镜像名称2}:{版本名称2}
    • [镜像名称1:版本名称1]：请替换为您所要推送的实际镜像的名称和版本名称。
    • [镜像仓库地址]：可在SWR控制台上查询，即Pull/Push指南页签中推送指令包含的域名。
    • [组织名称]：请替换为您创建的组织。
    • [镜像名称2:版本名称2]：请替换为您期待的镜像名称和镜像版本。
  5. 在虚拟机中执行3复制的镜像推送指令，命令如下： 
    ctr -n k8s.io images push --user {用户名}:{密码} {镜像仓库地址}/{组织名称}/{镜像名称}:{版本名称}
    • -n k8s.io：指定containerd命名空间，k8s集群中默认使用k8s.io命名空间。
    • {用户名}:{密码}：参数建议使用推送拉取指令自动生成。

  6. 检查镜像是否推送成功。

    • 如果推送的镜像达到配额，不能推送新的镜像，但是存量镜像如果镜像版本没有超过配额仍可继续推送。
    • 如果推送的某个镜像版本达到配额，则该镜像不能继续推送，其他镜像不受影响。
    • 并发推送镜像或镜像版本时，可能存在推送成功的镜像或镜像版本超过配额的场景。此时需先删除所有超出配额的镜像或镜像版本，然后删除镜像或镜像版本才能释放出可用配额。

常见问题

为什么使用客户端推送镜像失败？

推送镜像其他问题

操作步骤

  1. 登录SWR控制台。
  2. 在左侧导航栏选择“我的镜像”，单击右上角“页面上传”。
  3. 在弹出的窗口中选择组织，单击“选择镜像文件”，选择要上传的镜像文件。

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

    图1 上传镜像

  4. 单击“开始上传”。

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

  • 如果推送的镜像达到配额，不能推送新的镜像，但是存量镜像如果镜像版本没有超过配额仍可继续推送。
  • 如果推送的某个镜像版本达到配额，则该镜像不能继续推送，其他镜像不受影响。
  • 并发推送镜像或镜像版本时，可能存在推送成功的镜像或镜像版本超过配额的场景。此时需先删除所有超出配额的镜像或镜像版本，然后删除镜像或镜像版本才能释放出可用配额。

常见问题

为什么通过页面上传镜像失败？

推送镜像其他问题

镜像推送完成后相关操作

镜像推送完成后，您还可以进行以下操作：

表1 操作说明

操作

说明

相关文档

在CCE集群中使用镜像创建工作负载

镜像推送成功后，在CCE集群中创建工作负载时可选择已推送的镜像。

创建无状态负载（Deployment）、创建有状态负载（StatefulSet）、创建普通任务（Job）、创建定时任务（CronJob）

编辑镜像属性

镜像推送后默认为私有镜像，您可以设置镜像的类型（"公开"或"私有"）、分类及描述。

编辑镜像

共享镜像

镜像推送后，您可以共享私有镜像给其他账号，并授予下载该镜像的权限。

共享镜像

配置镜像触发器

容器镜像服务可搭配云容器引擎CCE、云容器实例CCI一起使用。实现镜像版本更新时自动更新使用该镜像的应用。

镜像触发器

设置镜像老化规则

镜像推送后，您可以添加镜像老化规则。容器镜像服务提供了按照镜像存活时间和保留镜像版本数目两种老化处理规则。

镜像老化

同步镜像到其他区域

您可以使用镜像同步功能帮助您把最新推送的镜像版本同步到其他区域镜像仓库内。支持自动同步和手动同步两种方式。

镜像同步

扫描镜像漏洞

容器镜像服务为您提供了镜像安全扫描的功能，您只需要一键就可以对您的镜像进行安全扫描。

镜像漏洞扫描

设置镜像加速器

由于运营商网络原因，会导致您拉取第三方镜像仓库的镜像(例如Docker Hub)变慢甚至下载失败。华为云容器镜像服务提供了镜像下载加速功能。

设置镜像加速器
父主题： 镜像管理

相关文档