文档中心

镜像仓库

OCI 制品

标准版实例拉取和推送镜像

标准版实例拉取和推送镜像

购买镜像仓库CR 标准版实例并创建完成命名空间后，您可以开始拉取和推送镜像。

前提条件

已创建镜像仓库标准版实例，操作详情参见创建标准版实例。

已创建设置镜像仓库标准版实例登录密码，详情参见标准版实例访问凭证。

已创建命名空间，详细操作参见创建命名空间。

已装 Docker，详细操作参见安装 Docker，且 Docker 版本为 1.19 及以上。

如果您的机器与镜像仓库处于不同网络，机器访问仓库必须通过公网访问，您需要开启访问控制的公网访问开关，详细操作参见访问控制。

说明

如果您的机器和镜像仓库处于同一网络下，机器访问仓库默认通过 VPC 访问。

推送镜像前，请确保本地已有镜像，且已知镜像的 ImageID 或镜像名称。

推送镜像

说明

推送镜像前无需在控制台创建 OCI 制品仓库。镜像仓库控制台将根据推送命令中 <OCI repository name> 自动创建私有 OCI 制品仓库。后续您可以通过修改 OCI 制品仓库类型，更新为公有 OCI 制品仓库，详情参见修改 OCI 制品仓库。

本地镜像推送至镜像仓库的过程中将进行压缩，因此控制台中镜像的容量通常小于本地镜像的容量。

本文以如下参数为例。

用户名	UserId	标准版实例	地域	命名空间	OCI 制品仓库
v**	1007***	test1	华北2（北京） cn-beijing	space	mysql

执行以下命令登录镜像仓库实例。

输入您在设置标准版实例访问凭证中设置的访问密码。

docker login --username=<Account name>@<UserID> <Instance name>-<Region>.cr.volces.com

示例：

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

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

docker tag [ImageId or OCI repository name] <Instance name>-<Region>.cr.volces.com/<Namespace>/<OCI repository name>:[Image tag]

示例：

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

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

docker push <Instance name>-<Region>.cr.volces.com/<Namespace>/<OCI repository name>:[Image tag]

示例：

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

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

拉取镜像

本文以如下参数为例。

用户名	UserId	标准版实例	地域	命名空间	OCI制品仓库
v**	1007***	test1	华北2（北京） cn-beijing	space	mysql

说明

公有镜像可匿名拉取，即无需登录镜像仓库实例直接拉取公有镜像。

执行以下命令登录镜像仓库实例。

输入您在设置标准版实例访问凭证中设置的访问密码。

docker login --username=<Account name>@<UserID> <Instance name>-<Region>.cr.volces.com

示例：

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

执行以下命令拉取镜像。

docker pull <Instance name>-<Region>.cr.volces.com/<Namespace>/<OCI repository name>:[Image tag]

示例：

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

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

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

最近更新时间：2025.08.26 11:54:57

这个页面对您有帮助吗？

有用

有用

无用

无用