使用 Helm Cli 将 chart 推送到 Harbor
原文参考:How to push a helm chart to Harbor using Helm CLI V3.7.2 and Harbor 2.4.0-d4affc2
背景问题
努力寻找适用于特定版本的 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 有三种选择
- 可以安装 helm 插件chartmuseum/helm-push并使用它来将 Helm chart 推送到 Harbor
- 您在本地使用
helm package
创建 Helm Chart 并通过 Harbor UI 上传文件tgz
- 从 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
下:
说明
请关注 危 ❤ 工中号【进击云原生】,更有 free 资源供您学习
本文由mdnice多平台发布