|
前言
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的时间
您可以单击右上角的图标在卡片视图和列表视图之间切换。

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

如果Charts是签名的,您可以从文件系统中选择相应的出处文件,然后单击UPLOAD将它们同时上传。
如果Charts上传成功,则会显示在Charts列表中。

列表Charts版本
若要查看Charts的可用版本,请单击Charts列表中的Charts名称。Charts详细信息显示以下信息:
• Charts版本号
• Charts版本的维护者
• 使用的模板引擎(默认为 gotpl )
• Charts版本的创建时间戳

Charts列表中的每个Chart至少有一个版本。您可以单击右上角的图标在卡片视图和Charts视图之间切换。
单击第一列中的复选框以选择一个或多个Charts版本,然后您可以执行以下操作:
• 单击“删除”可从Charts存储库服务器中删除选定的Charts版本。支持批量操作。
• 单击DOWNLOAD下载Charts工件文件。不支持批量操作。
• 单击UPLOAD为当前Charts上载新版本。

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


按标签过滤Charts版本
Charts版本可以按标签过滤:


查看Charts版本详细信息
单击Charts版本号链接以打开图表版本详细信息视图。您可以在此处查看有关指定图表版本的更多详细信息。有三个内容部分:
•
总结:
◦
Charts自述文件
◦
总体元数据,如主页、创建的时间戳和应用程序版本
◦
相关Helm命令,如 helm add repo 、 helm install 等,供参考。

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

•
Values:
◦
显示 values.yaml 文件的内容,并突出显示代码预览
◦
您可以单击右上角的图标按钮在YAML文件视图和键值对列表视图之间切换。

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

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

helm version
1.
2.
3.
4.

将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
1.
提供CA文件和证书文件。这是必要的,因为Helm中存在问题。
•
添加Harbor项目作为单独的索引入口点。
在此模式下,Helm只能拉取指定项目中的图表。

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

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

helm plugin install
https:///chartmuseum/helm-push
1.
成功安装后,运行 push 命令上传图表:

helm push --ca-file=ca.crt --username=admin --password=
passw0rd chart_repo/hello-helm-0.1.0.tgz myrepo
1.
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
1.
2.
3.
4.
5.
6.
如果一切就绪,请在Kubernetes集群中安装Charts:

helm install --ca-file=ca.crt --username=admin --password=Passw0rd --version 0.1
.10 repo248/chart_repo/hello-helm
1.
有关其他更多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"}
1.
2.
3.

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

helm registry login --insecure
xx.xx.xx.xx
1.
由于Helm中的问题,未启用https认证的harbor需要加上–insecure 参数

使用CLI将Charts推送到工件存储库
登录后,运行 helm package 命令,保存一个chart目录,为工件的推送做好准备。

helm package dummy-chart --version
1.
chart保存后,运行 helm push 命令推送图表:

helm push --plain-http dummy-chart:version oci://xx.xx.xx.xx/chartrepo
1.
未启用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
1.

在Harbor界面中管理Helm Charts工件
将图表推送到与OCI兼容的Harbor注册中心,就像对待任何其他类型的工件一样。您可以列出、复制、删除、更新标签,获取详细信息,以及为它们添加或删除标签,就像您可以为容器镜像一样。
(责任编辑:liangzh) |
