开启镜像仓库 CR 业务并创建完成命名空间后，您可以开始推送和拉取镜像。

使用限制

镜像仓库实例不同规格版本存在部分功能差异。如果您有较高的业务需求，例如对推送的速度和并发数有更高的要求，建议 购买标准版实例，并将 小微版实例同步至标准版实例。迁移方案详情参见 镜像仓库体验版迁移标准版方案。

前提条件

• 已创建镜像仓库小微版实例，操作详情参见 创建小微版实例。
• 已创建设置镜像仓库小微版实例登录密码，详情参见 小微版实例访问凭证。
• 已创建命名空间，详细操作参见 创建命名空间。
• 已装 Docker，具体操作，请参见 安装 Docker，并且 Docker 版本为 1.19 及以上。
• 推送镜像前，请确保本地已有镜像，且已知镜像的 ImageID 或镜像名称。

推送镜像

本文以如下参数为例。

1. 执行以下命令登录仓库实例。
   输入您在 设置小微版实例访问凭证 中设置的访问密码。

   docker login --username=<火山引擎帐号用户名>@<UserID> cr-<小微版实例所在地域>.volces.com
   

   示例：

   docker login --username=v**@1007*** cr-cn-beijing.volces.com
   

2. 执行以下命令标记本地镜像。

   docker tag [ImageId或镜像名称] cr-<小微版实例所在地域>.volces.com/<命名空间名称>/<OCI 制品仓库名称>:[镜像版本号]
   

   示例：

   docker tag mysql cr-cn-beijing.volces.com/space/mysql:latest
   

3. 执行以下命令推送镜像至仓库实例。

   docker push  cr-<小微版实例所在地域>.volces.com/<命名空间名称>/<OCI 制品仓库名称>:[镜像版本号]
   

   示例：

   docker push cr-cn-beijing.volces.com/space/mysql:latest
   

   系统显示类似如下信息，表示您已成功推送镜像。
   

拉取镜像

本文以如下参数为例。

1. 执行以下命令登录仓库实例。
   输入您在 设置小微版实例访问凭证 中设置的访问密码。

   docker login --username=<火山引擎账号用户名>@<UserID> cr-<小微版实例所在地域>.volces.com
   

   示例：

   docker login --username=v**@1007*** cr-cn-beijing.volces.com
   

2. 执行以下命令拉取镜像。

   docker pull cr-<小微版实例所在地域>.volces.com/<命名空间名称>/<OCI 制品仓库名称>:[镜像版本号]
   

   示例：

   docker pull cr-cn-beijing.volces.com/space/mysql:lastest
   

   系统显示类似如下信息，表示您已成功从镜像仓库拉取镜像。

   Status: Image is up to date for cr-cn-beijing.volces.com/space/mysql:lastest