推送和拉取 Helm Chart

镜像仓库标准版支持托管 Helm Chart，本文介绍使用标准版实例推送拉取 Chart 的步骤。

前提条件

• 已注册火山引擎账号。详细操作，请参见 如何进行账号注册。
• 账号已通过企业认证。详细操作，请参见 实名认证。

  注意

  仅支持企业实名认证的用户使用火山引擎镜像仓库 CR 产品。

• 已开通镜像仓库产品。若未开通，请登录 镜像仓库控制台，根据系统引导开通产品。
• 若需要 IAM 用户操作镜像仓库，请确保已完成镜像仓库相关策略和角色授权，具体操作说明参见 管理授权。
• 已在业务服务器中安装 Helm 3 客户端。详细操作，请参见 官网。

  注意

  当前 Helm 3.13.0 和 3.13.1 客户端版本存在缺陷，请选择其他的版本使用。

• 已在业务服务器中开启 OCI 使用支持：export HELM_EXPERIMENTAL_OCI=1。

步骤一：创建标准版实例

具体操作请参见 购买标准版实例。

步骤二：设置访问密码

在使用镜像仓库前需要设置仓库访问密码，此处设置的访问密码即 docker login 的密码。

1. 登录 镜像仓库控制台。
2. 在 实例列表 页面单击目标标准版实例，进入该标准版实例。
3. 在左侧导航栏选择 概览，进入 概览 页面。
   进入未设置访问密码的标准版实例页面时，系统会自动弹出 设置仓库实例密码 对话框。
4. 在 设置仓库实例密码 对话框中输入密码和确认密码后，单击 确定，完成密码的设置。

步骤三：创建命名空间

1. 在标准版实例页面，单击左侧导航栏的 命名空间，进入 命名空间 页面。
2. 单击 创建命名空间，在弹出的 创建命名空间 对话框中填写参数后，单击 确定，完成命名空间的创建。

   参数	说明
   名称	根据系统提示，设置命名空间名称，必须为标准版实例级别唯一。

步骤四：创建 OCI 制品仓库

1. 在标准版实例页面，单击左侧导航栏的 OCI制品仓库，进入 OCI制品仓库页面。
2. 单击 创建OCI制品仓库，在弹出的对话框中填写参数信息后，单击 确定，完成 OCI 制品仓库的创建。

   参数	说明
   命名空间	选择本文上方 步骤三 中创建的命名空间。
   类型	选择该 OCI 制品仓库的类型。本示例设置为 私有。 公有类型：拥有全读写权限的子用户可推送或拉取镜像，其他用户可匿名拉取镜像。 私有类型：拥有全读写权限的子用户可推送或拉取镜像 ，拥有只读权限的子用户可拉取镜像。
   名称	输入该 OCI 制品仓库的名称。制品仓库名称，必须为命名空间级别唯一。
   描述	输入该 OCI 制品仓库的详情描述。可以为空。

步骤五：推送或拉取 Chart

登录镜像仓库

1. 在 OCI制品仓库 页面，单击本文上方 步骤四 中创建的 OCI 制品仓库名称。

2. 在 OCI 制品仓库详情页面，单击 Chart使用指南 页签，查看操作 Chart 的相关命令。

   在 Chart使用指南 页签，单击每个命令右侧的

   

   图标，可复制该命令。此处可复制 登录 Registry 命令备用。

   

3. 登录 前提条件 中已安装 Helm 3 客户端。

4. 执行已复制的 登录 Registry 命令，登录镜像仓库标准版实例。
   输入您在本文上方 步骤二 中设置的访问密码。系统返回login succeeded，表示登录成功。

推送 Chart

成功登录镜像仓库后，可以推送 Chart 到镜像仓库标准版实例中。

1. 在 OCI 制品仓库详情页面的 Chart使用指南 页签，复制 上传 Chart 下的打包（save/package）Chart 命令。
   

2. 在 Helm 客户端执行已复制的命令，打包 Chart。
   其中，将[Chart 名称]替换为本地 Chart 的名称；将[Chart 版本号]替换为需要设置的 Chart 版本号。

   注意

   请勿将[Chart 版本号]和本标准版实例中已上传镜像的[镜像版本号]设置为同一版本号，避免版本号覆盖导致老数据丢失。

   • Helm 3.7 之前版本完整命令示例：

   helm chart save redis cr-doc-cn-beijing.cr.volces.com/test/test:chart-v1    
   

   • Helm 3.7（含）之后版本完整命令示例：

   helm package redis --version chart-v1    
   

   系统返回类似如下信息，表示打包 Chart 成功。

   Successfully packaged chart and saved it to: /Users/bytedance/redis-chart-v1.tgz
   

3. 在 OCI 制品仓库详情页面的 Chart使用指南 页签，复制 上传 Chart 下的推送（push）Chart 命令。
   

4. 在 Helm 客户端执行已复制的命令，推送 Chart。
   其中，将[Chart 名称]替换为本地 Chart 的名称；将[Chart 版本号]替换为上一步设置的 Chart 版本号。

   • Helm 3.7 之前版本完整命令示例：

   helm chart push cr-doc-cn-beijing.cr.volces.com/test/test:chart-v1    
   

   • Helm 3.7（含）之后版本完整命令示例：

   helm push redis-chart-v1.tgz oci://cr-doc-cn-beijing.cr.volces.com/test    
   

   系统返回类似如下信息，表示推送 Chart 成功。

   Pushed: cr-doc-cn-beijing.cr.volces.com/test/redis:chart-v1
   Digest: sha256:f8483b3db04955b2******e70019a81d35aaa88fbd389c285c561b47c0******
   

拉取 Chart

成功登录镜像仓库后，可以从镜像仓库 CR 实例中拉取 Chart 到本地。

1. 在 OCI 制品仓库详情页面，单击 概览 > Chart 页签，查看需要拉取的 Chart 版本号。
   
2. 单击 Chart使用指南 页签，复制 下载 Chart 下的拉取（pull）Chart 命令。
   
3. 在 Helm 客户端执行已复制的命令，拉取 Chart。
   其中，将[Chart 版本号]替换为需要拉取的 Chart版本号。
   • Helm 3.7 之前版本完整命令示例：

   helm chart pull cr-doc-cn-beijing.cr.volces.com/test/redis:v1    
   

   • Helm 3.7（含）之后版本完整命令示例：

   helm pull oci://cr-doc-cn-beijing.cr.volces.com/test/redis --version v1    
   

   系统返回类似如下信息，表示推送 Chart 成功。

   Pulled: cr-doc-cn-beijing.cr.volces.com/test/redis:v1
   Digest: sha256:d1055f45acf6f9******0d807264ff97e5d02d739d1be7bb3dd0bf03ad******