跳到主要内容

Helm 集成

Helm 是 Kubernetes 的包管理工具。Helm Chart 为 Kubernetes YAML 清单文件提供了模板语法。通过 Helm，用户可以创建可配置的 deployment，而不仅仅只能使用静态文件。如果你需要创建自己的 Deployment 商店应用，请参见 Helm 文档。

RKE2 不需要任何特殊配置即可配合 Helm 命令行工具一起使用。请确保你已按照集群访问部分正确设置了 kubeconfig。RKE2 包含一些其他功能，让你可以使用 rancher/helm-release CRD 更轻松地部署传统的 Kubernetes 资源清单和 Helm Chart。

本节涵盖以下主题：

自动部署清单和 Helm Chart​

在 /var/lib/rancher/rke2/server/manifests 中找到的 Kubernetes 清单都会以类似于 kubectl apply 的方式自动部署到 RKE2。以这种方式部署的清单作为 AddOn 自定义资源进行管理，你可以通过运行 kubectl get addon -A 查看它们。你能找到用于打包组件的 AddOn，例如 CoreDNS、Nginx-Ingress 等。AddOn 由部署控制器自动创建，并根据它们在清单目录中的文件名命名。

你也可以将 Helm Chart 部署为 AddOn。RKE2 包含一个 Helm Controller，它使用 HelmChart 自定义资源定义 (CRD) 管理 Helm Chart。

使用 Helm CRD​

HelmChart 资源定义捕获了你通常传递给 helm 命令行工具的大部分选项。以下示例说明了如何从默认 Chart 仓库部署 Grafana，并覆盖某些默认的 Chart 值。请注意，HelmChart 资源本身位于 kube-system 命名空间中，但 Chart 的资源将部署到 monitoring 命名空间。

apiVersion: helm.cattle.io/v1
kind: HelmChart
metadata:
  name: grafana
  namespace: kube-system
spec:
  chart: stable/grafana
  targetNamespace: monitoring
  set:
    adminPassword: "NotVerySafePassword"
  valuesContent: |-
    image:
      tag: master
    env:
      GF_EXPLORE_ENABLED: true
    adminUser: admin
    sidecar:
      datasources:
        enabled: true

HelmChart 字段定义​

字段默认描述Helm 参数/标志等效项
nameHelm Chart 名称NAME
spec.chart仓库中的 Helm Chart 名称，或 chart archive (.tgz) 的完整 HTTPS URLCHART
spec.targetNamespacedefaultHelm Chart 目标命名空间--namespace
spec.versionHelm Chart 版本（通过仓库安装时）--version
spec.repoHelm Chart 仓库 URL--repo
spec.helmVersionv3要使用的 Helm 版本（v2 或 v3）
spec.bootstrapFalse如果需要此 Chart 来引导集群（Cloud Controller Manager 等），请设置为 True
spec.set覆盖简单的默认 Chart 值。优先于通过 valuesContent 设置的选项。--set / --set-string
spec.valuesContent通过 YAML 文件内容覆盖复杂的默认 Chart 值--values
spec.chartContentBase64 编码的 chart archive .tgz，覆盖 spec.chartCHART

使用 HelmChartConfig 自定义打包组件​

为了允许覆盖部署为 HelmCharts（例如 Canal、CoreDNS、Nginx-Ingress 等）的打包组件的值，RKE2 支持通过 HelmChartConfig 资源进行自定义部署。HelmChartConfig 资源必须与对应的 HelmChart 名称和命名空间匹配，并且支持提供额外的 valuesContent，它作为附加值文件传递给 helm 命令。

注意：HelmChart spec.set 值会覆盖 HelmChart 和 HelmChartConfig spec.valuesContent 设置。

例如，要自定义打包的 CoreDNS 配置，你可以创建一个名为 /var/lib/rancher/rke2/server/manifests/rke2-coredns-config.yaml 的文件并使用以下内容填充它:

apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
  name: rke2-coredns
  namespace: kube-system
spec:
  valuesContent: |-
    image: coredns/coredns
    imageTag: v1.7.1

你可以在 RKE2 Chart 仓库找到所有打包的 Helm Chart，包括其文档和默认值。