前言

Helm是Kubernetes的包管理器。Helm使用一种称为charts的打包格式。自1.6.0版本以来，Harbor是一个复合的云原生注册表，支持容器镜像管理和Helm Chart管理。对Harbor中Helm charts的访问由基于角色的访问控制（RBAC）控制，并受项目限制。

有两个地方可以管理Helm Charts。

  • ChartMuseum，由Harbor自1.6.0版起提供

  • 兼容OCI的注册表，由Harbor从2.0.0版开始提供

    这意味着您可以通过同一组项目和存储库管理Helm Charts以及容器镜像。

harbor 版本更迭

Harbor在v1.6版本开始支持Helm Chart仓库功能，这样就可以利用 harbor 同时管理镜像和 helm charts 了，无需另外部署一套Helm Chart系统。在harbor中，chart仓库由chartmuseum以插件的方式提供，可以自己选择安装或者不安装。

ChartMuseum：提供了API管理非OCI规范的Helm Chart。在安装了ChartMuseum组件后，当用户使用“helm”命令向Harbor推送或拉取Chart时，Harbor的Core组件会首先收到请求，在校验后将请求转发给ChartMuseum进行Chart文件的读写。

随着兼容OCI规范的Helm Chart在社区上被更广泛地接受，Helm Chart能以Artifact的形式在Harbor中存储和管理，不再依赖ChartMuseum，因此Harbor会在后续版本中移除对ChartMuseum的支持。

虽然被废弃，但是并不意味着不能用Harbor存储chart了，而是用 OCI chart替代。

  • 从v2.6.0 开始弃用Chartmuseum，并在v2.8.0中开始删除。

在Harbor Interface中使用ChartMuseum管理Helm Chart

 Charts列表

登录Harbor界面，点击Projects，选择项目进入项目详情页面。单击Helm Charts选项卡可查看现有Helm Charts，其中包含以下信息：

  • Helm Chart名称
  • Charts的状态：Active或Deprecated
  • Charts版本数
  • 创建Chart的时间

list charts

您可以单击右上角的图标在卡片视图和列表视图之间切换。

上传新Charts

  1. 单击UPLOAD打开Charts上传对话框。
  2. 选择要从文件系统上载的Charts。
  3. 单击UPLOAD将其上载到Charts存储库服务器。

upload charts

如果Charts是签名的，您可以从文件系统中选择相应的出处文件，然后单击UPLOAD将它们同时上传。

如果Charts上传成功，则会显示在Charts列表中。

 列表Charts版本

若要查看Charts的可用版本，请单击Charts列表中的Charts名称。Charts详细信息显示以下信息：

  • Charts版本号
  • Charts版本的维护者
  • 使用的模板引擎（默认为 gotpl ）
  • Charts版本的创建时间戳

list charts versions

Charts列表中的每个Chart至少有一个版本。您可以单击右上角的图标在卡片视图和Charts视图之间切换。

单击第一列中的复选框以选择一个或多个Charts版本，然后您可以执行以下操作：

  • 单击“删除”可从Charts存储库服务器中删除选定的Charts版本。支持批量操作。
  • 单击DOWNLOAD下载Charts工件文件。不支持批量操作。
  • 单击UPLOAD为当前Charts上载新版本。

向Charts版本添加标签和从Charts版本删除标签

如果您具有Harbor系统管理员、项目管理员或项目开发人员角色，则可以单击“添加标签”向图表版本添加标签或从图表版本中删除标签。

add labels to chart versions

按标签过滤Charts版本

Charts版本可以按标签过滤：

filter chart versions by labels

查看Charts版本详细信息

单击Charts版本号链接以打开图表版本详细信息视图。您可以在此处查看有关指定图表版本的更多详细信息。有三个内容部分：

  •  总结：

    • Charts自述文件

    • 总体元数据，如主页、创建的时间戳和应用程序版本

    • 相关Helm命令，如 helm add repo 、 helm install 等，供参考。

      chart details

  •  依赖：

    • 显示依赖子Chart的名称、版本和存储库

      chart dependencies

  •  Values：

    • 显示 values.yaml 文件的内容，并突出显示代码预览

    • 您可以单击右上角的图标按钮在YAML文件视图和键值对列表视图之间切换。

      chart values

您可以点击右上角的下载按钮下载YAML文件。

通过Helm CLI使用ChartMuseum

作为Helm chart存储库，Harbor可以与Helm CLI进行互操作。要安装Helm CLI，请参阅安装Helm。运行命令 helm version 以确保Helm CLI的版本为v2.9.1或更高版本。

helm version

#Client: &version.Version{SemVer:"v2.9.1", GitCommit:"20adb27c7c5868466912eebdf6664e7390ebe710", GitTreeState:"clean"}
#Server: &version.Version{SemVer:"v2.9.1", GitCommit:"20adb27c7c5868466912eebdf6664e7390ebe710", GitTreeState:"clean"}

将Harbor添加到存储库列表

在使用Helm CLI之前，使用 helm repo add 命令将Harbor添加到存储库列表中。支持两种不同的模式。

  • 添加Harbor作为统一的单一索引入口点。

    在这种模式下，Helm可以知道位于不同项目中的所有Charts，以及当前经过身份验证的用户可以访问的Charts。

    helm repo add --ca-file ca.crt --username=admin --password=Passw0rd myrepo https://xx.xx.xx.xx/chartrepo

    提供CA文件和证书文件。这是必要的，因为Helm中存在问题。

  • 添加Harbor项目作为单独的索引入口点。

    在此模式下，Helm只能拉取指定项目中的图表。

    helm repo add --ca-file ca.crt --username=admin --password=Passw0rd myrepo https://xx.xx.xx.xx/chartrepo/myproject

使用CLI将Charts推送到存储库服务器

作为替代方案，您也可以使用CLI上传图表。本机Helm CLI不支持它。必须在推送前安装社区插件。运行下面的 helm plugin install 命令，先安装 helm-push 插件。

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

成功安装后，运行 push 命令上传图表：

helm push --ca-file=ca.crt --username=admin --password=passw0rd chart_repo/hello-helm-0.1.0.tgz myrepo

push 命令尚不支持推送已签名chart的prov文件。

 安装Charts

在安装之前，请确保Helm已使用 helm init 命令正确初始化，并且图表索引已与 helm repo update 命令同步。

如果您不确定图表的位置，请使用关键字搜索图表：

helm search hello

#NAME                            CHART VERSION   APP VERSION     DESCRIPTION
#local/hello-helm                0.3.10          1.3             A Helm chart for Kubernetes
#myrepo/chart_repo/hello-helm    0.1.10          1.2             A Helm chart for Kubernetes
#myrepo/library/hello-helm       0.3.10          1.3             A Helm chart for Kubernetes

如果一切就绪，请在Kubernetes集群中安装Charts：

helm install --ca-file=ca.crt --username=admin --password=Passw0rd --version 0.1.10 repo248/chart_repo/hello-helm

有关其他更多Helm命令，如如何签署图表，请参阅Helm文档。

使用兼容OCI的Harbor注册表管理Helm Charts

Helm 3支持与OCI兼容的注册表操作，包括推和拉。要安装最新的Helm CLI，请参阅安装Helm。另外，运行 helm version 以确保Helm CLI的版本为v3.0.0+。

helm version

#version.BuildInfo{Version:"v3.2.1", GitCommit:"fe51cd1e31e6a202cba7dead9552a6d418ded79a", GitTreeState:"clean", GoVersion:"go1.13.10"}

登录到OCI兼容的Harbor注册表

在使用Harbor的OCI兼容注册表拉或推Helm Charts之前，应该使用 helm registry login 命令记录Harbor。

helm registry login --insecure xx.xx.xx.xx

由于Helm中的问题，未启用https认证的harbor需要加上--insecure 参数

使用CLI将Charts推送到工件存储库

登录后，运行 helm package 命令，保存一个chart目录，为工件的推送做好准备。

helm package dummy-chart --version

chart保存后，运行 helm push 命令推送图表：

helm push --plain-http dummy-chart:version oci://xx.xx.xx.xx/chartrepo

未启用https认证，需要加上--plain-http参数

使用CLI从工件存储库中拉取Charts

要从Harbor的OCI兼容注册表中拉取chart，请运行 helm pull 命令，就像使用Docker CLI拉取图像一样。

helm pull --plain-http oci://xx.xx.xx.xx/chartrepo/dummy-chart --version 0.2

在Harbor界面中管理Helm Charts工件

将图表推送到与OCI兼容的Harbor注册中心，就像对待任何其他类型的工件一样。您可以列出、复制、删除、更新标签，获取详细信息，以及为它们添加或删除标签，就像您可以为容器镜像一样。