镜像仓库
镜像仓库
文档指南
请输入
- 文档首页
镜像仓库镜像仓库 CR快速入门推送和拉取制品
复制全文
下载 pdf推送和拉取制品
文档反馈
问问助手本文介绍如何创建镜像仓库实例，并通过 Docker、Nerdctl 或 Helm 客户端推送和拉取容器制品（镜像/Helm Chart）。
背景信息
镜像仓库 CR 支持以下三种客户端工具进行制品的推送和拉取：
客户端 | 用途 |
Docker | 推送和拉取容器镜像。 |
Nerdctl | 推送和拉取容器镜像（containerd 原生工具）。 |
Helm | 推送和拉取 Helm Chart。 |
前提条件
账号和权限
- 已注册火山引擎账号，详细操作请参见 如何进行账号注册。
- 完成企业账号实名认证，详细操作请参见 实名认证。
- 已开通镜像仓库产品。若未开通，请登录 镜像仓库控制台，根据系统引导开通产品。
- （可选）若需要 IAM 用户操作镜像仓库，请确保已完成镜像仓库相关策略和角色授权，具体操作说明参见 管理授权。
客户端环境
已在业务服务器中安装对应的客户端工具，并准备对应的镜像或 Chart 文件。
网络配置
步骤一：创建标准版实例
- 登录 镜像仓库控制台。
- 在顶部导航栏，选择目标地域。
- 在左侧导航栏单击 实例列表 后，在右侧页面 实例列表 区域单击 创建实例。
- 在 创建仓库实例 页面，填写 购买信息。
说明
- 参数说明名称设置标准版实例的名称。需确保同一个地域下，实例名称的唯一性。说明标准版实例创建成功后，实例名称不可修改。计费类型本示例选择 按量计费。
- 在 规格套餐 中，单击 标准版。
- 查看实例规格对比和配置费用，确认无误后，单击 确认订单。
- 在 确认订单 页面再次确认订单信息后，仔细阅读并勾选 我已阅读并同意《镜像仓库服务条款》。
- 单击 确定 提交订单，开始创建标准版实例。
说明
您支持在 实例列表 页面查看实例创建进度。当 实例状态 为 运行中 时，表示实例创建成功
步骤二：初始化实例
- 在左侧导航栏单击 实例列表 后，在右侧页面 实例列表 区域中找到目标标准版实例，单击 进入实例。
- 在 初始化实例 页面，配置实例初始化信息。
说明
- 配置网络信息。
- 参数说明公网访问说明公网开启可能需 5~10 min，后续可以通过 访问控制 页面查看开启状态。开启公网访问后，支持公网环境中的资源直接推拉标准版实例中的镜像。
- 单击 下一步，设置实例访问密码。
- 参数说明设置镜像仓库密码支持设置固定的镜像仓库密码。
- 单击 下一步，选择或创建实例所归属的命名空间。即可生成并复制镜像登录、推送拉取的指令。
- 单击 完成，完成实例初始化。
步骤三：推送和拉取制品
制品管理操作相关代码中，占位符及对应示例说明如下：
参数 | 占位符 | 示例值 |
子用户名 | User name | v** |
子用户 ID | User ID | 1007*** |
实例 | Instance | test1 |
地域 | Region | cn-beijing |
命名空间 | Namespace | space |
OCI 制品仓库 | Repository |
|
制品版本 |
|
|
推送镜像
- 通过命令行工具执行以下命令，并输入已设置的访问密码，登录镜像仓库实例。
-
- 示例：
-
- 执行以下命令，标记本地镜像。
-
- 示例：
-
- 执行以下命令，推送镜像至镜像仓库实例。
-
- 示例：
-
- 系统显示类似如下信息，表示您已成功推送镜像。
-
拉取镜像
说明
公有镜像可匿名拉取，即无需登录镜像仓库实例直接拉取公有镜像。
- 通过命令行工具执行以下命令，并输入已设置的访问密码，登录镜像仓库实例。
-
- 示例：
-
- 执行以下命令，拉取镜像。
-
- 示例：
-
- 系统显示类似如下信息，表示您已成功从镜像仓库拉取镜像。
-
推送镜像
- 通过命令行工具执行以下命令，并输入已设置的访问密码，登录镜像仓库实例。
-
- 示例：
-
- 执行以下命令，标记本地镜像。
-
- 示例：
-
- 执行以下命令，推送镜像至镜像仓库实例。
-
- 示例：
-
- 系统显示类似如下信息，表示您已成功推送镜像。
-
拉取镜像
说明
公有镜像可匿名拉取，即无需登录镜像仓库实例直接拉取公有镜像。
- 通过命令行工具执行以下命令，并输入已设置的访问密码，登录镜像仓库实例。
-
- 示例：
-
- 执行以下命令，拉取镜像。
-
- 示例：
-
- 系统显示类似如下信息，表示您已成功从镜像仓库拉取镜像。
-
推送 Chart
- 通过命令行工具执行以下命令，并输入已设置的访问密码，登录镜像仓库实例。
-
- 示例：
-
- 执行以下命令，打包 Chart 文件。
-
- 示例：
-
- 执行以下命令，推送 Chart 至镜像仓库实例。
-
- 示例：
-
拉取 Chart
- 通过命令行工具执行以下命令，并输入已设置的访问密码，登录镜像仓库实例。
-
- 示例：
-
- 执行以下命令，拉取 Chart。
-
- 示例：
-
- 系统返回类似如下信息，表示推送 Chart 成功。
-
推送 Chart
- 通过命令行工具执行以下命令，并输入已设置的访问密码，登录镜像仓库实例。
-
- 示例：
-
- 执行以下命令，打包 Chart 文件。
-
- 示例：
-
- 执行以下命令，推送 Chart 至镜像仓库实例。
-
- 示例：
-
- 系统返回类似如下信息，表示打包 Chart 成功。
-
拉取 Chart
- 通过命令行工具执行以下命令，并输入已设置的访问密码，登录镜像仓库实例。
-
- 示例：
-
- 执行以下命令，拉取 Chart。
-
- 示例：
-
- 系统返回类似如下信息，表示推送 Chart 成功。
-
最近更新时间：2026.06.25 20:40:54
这个页面对您有帮助吗？
有用
有用
无用
无用