进击云原生

V2

2022/11/22阅读:27主题:山吹

使用 Helm Cli 将 chart 推送到 Harbor

使用 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 有三种选择

  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为你自己的注册表地址;
  • harborchart包名称,1.7.4harbor 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 资源供您学习

分类:

后端

标签:

运维部署

作者介绍

进击云原生
V2

公众号:进击云原生