使用 Helm Cli 将 chart 推送到 Harbor

背景问题

努力寻找适用于特定版本的 Harbor 和 Helm 的文档。

我尝试添加我的仓库（repo）

helm repo add harbor https://myharbor.mydomain.com/chartrepo/myproject --username myusername --password mypassword

目前没有问题。

然后尝试在本地目录（.tgz 文件）中推送图表（chart）

helm push myhelmchart.tgz harbor

我收到错误Error: scheme prefix missing from remote (e.g. "oci://")

如果我尝试

helm push myhelmchart.tgz oci://harbor

我收到错误dial tcp: lookup harbor: no such host

如果尝试：

helm repo add harbor oci://myharbor.mydomain.com/chartrepo/myproject --username myusername --password

我收到错误looks like oci://myharbor.mydomain.com/chartrepo/myproject is not a valid chart repository

如果尝试直接推送，而不使用已注册的repo

helm push myhelmchart.tgz oci://myharbor.mydomain.com/chartrepo/myproject

收到错误消息Error: unexpected status: 401 Unauthorized。

如果先登录…

helm registry login myharbor.mydomain.com/chartrepo/myproject
Username: myusername
Password: mypassword
Login Succeeded

再次尝试 push

helm push myhelmchart.tgz oci://myharbor.mydomain.com/chartrepo/myproject

相同的错误Error: unexpected status: 401 Unauthorized

我的目标是能够将 helm chart 推入 Harbor 并让它们显示在下面区域中：

解决方案

将 helm chart 推送到 Harbor 有三种选择

1. 可以安装 helm 插件chartmuseum/helm-push并使用它来将 Helm chart 推送到 Harbor
2. 您在本地使用 helm package 创建 Helm Chart 并通过 Harbor UI 上传文件tgz
3. 从 Helm 3.8 版开始，支持从符合 OCI 标准的容器注册表（例如 Harbor）中推送和拉取 Charts。但是 3.7.1 中是实验特性，需要加环境变量HELM_EXPERIMENTAL_OCI=1开启

为了将来安全起见，建议切换到选项 3，因为 Chartmuseum 已在 Harbor 中标记为已弃用。

Helm 3.7.1 push pull 示例

以下是如何将 Helm 3.7.1 版本 Chart push/pull 到 harbor 2.1.0 OCI 兼容的注册表的简要说明

将 Helm Chart 推送到 OCI 注册表

先登录：

HELM_EXPERIMENTAL_OCI=1 helm registry login -u myusername container-registry.com -p mypassword

• container-registry.com为你自己的注册表地址
• -u后加用户名
• -p后加密码。

然后推送：

HELM_EXPERIMENTAL_OCI=1 helm push harbor-1.7.4.tgz oci://container-registry.com/proj

• harbor-1.7.4.tgz 是要推送的 chart 包；
• container-registry.com为你自己的注册表地址；
• proj 是你的项目名称

示例：

# 登录
HELM_EXPERIMENTAL_OCI=1 helm registry login harbor.test.ss.cn -u admin -p test123

# 推送
HELM_EXPERIMENTAL_OCI=1 helm push capo-0.1.0.tgz oci://harbor.test.ss.cn/cloudnative

推送后，harbor 2.1.0 显示在了 Repository 下，而不是 Helm Charts 下：

从 OCI 注册表中拉取并安装 Helm Chart

helm pull oci://container-registry.com/proj/harbor --version 1.7.4

• container-registry.com为你自己的注册表地址；
• harbor 是chart包名称，1.7.4 是harbor chart 包版本；
• proj 是你的项目名称

**提醒：**这是将文件tgz pull 到当前目录。与先添加 repo 然后拉取，再次执行安装 Chart 的繁琐操作不同。

**温馨提示：**上述操作在 v3.6.3 版本的 helm 上 pull 时会报错。在 v3.4.2 版本的 helm pull 会提示Error: scheme "oci" not supported

您可以使用 OCI 注册表一次完成所有操作：

helm install myrelease oci://container-registry.com/container-registry/harbor --version 1.7.4

template和的相同程序upgrade

该oci://协议也可用于各种其他子命令。这是一个完整的列表：

helm pull
helm show
helm template
helm install
helm upgrade

Helm 文档有一个包含更多 OCI 相关示例的页面。

Helm 3.7.1 安装 helm-push 插件

使用以下命令下载并安装 helm-push 插件：

helm plugin install https://github.com/chartmuseum/helm-push

确保您已使用以下命令将 Harbor 存储库添加到 helm：

helm repo add myccrepo https://myharbor.mydomain.com/chartrepo/myproject --username myusername --password mypassword

请注意 url 中的 /chartrepo，这很重要且没有很好的文档说明，但需要让 Chart 显示在 Harbor 的 Helm Charts 下

使用以下命令将 Chart 推送到 Harbor：

$ helm cm-push myhelmchart-0.1.0.tgz myccrepo
Pushing myhelmchart-0.1.0.tgz to myccrepo...
Done.

检查 Harbor project -> helm charts，这样推送后，是存储在 Helm Charts 下，而非 Repository 下：

参考

How to push a helm chart to Harbor using Helm CLI V3.7.2 and Harbor 2.4.0-d4affc2

说明

请关注 危 ❤ 工中号【进击云原生】，更有 free 资源供您学习

本文由mdnice多平台发布