集群模板

集群模板包含 Kubernetes 配置和节点池配置，允许单个模板包含 Rancher 在云提供商中配置新节点并在这些节点上安装 Kubernetes 所需的所有信息。

概述

集群模板以 Helm Chart 的形式提供。要使用集群模板，你需要克隆和复刻模板，根据你的用例更改模板，然后在 Rancher 管理集群上安装 Helm Chart。如果 Helm Chart 安装在 Rancher 管理集群上，会创建一个新的集群资源，Rancher 使用它来配置新集群。

使用模板配置集群后，对模板的任何更改都不会影响集群。使用集群模板创建集群后，集群的配置和基础设施可能会发生变化，因为集群模板没有任何执行限制。

集群模板可以使用任何 Kubernetes 发行版。现在，我们提供一个带有 RKE2 Kubernetes 集群的示例。将来我们可能会提供更多使用其他 Kubernetes 发行版的示例。

Rancher 不管理集群模板的版本控制。版本控制在包含模板的 Helm Chart 的仓库中处理。

请参阅 RKE2 集群模板的示例仓库。

在本节中，你将学习如何将集群模板添加到 local 集群的 Chart 仓库列表中。这样，当用户安装新的 Kubernetes 集群时，Rancher 将提供集群模板的选项。

先决条件：

转到集群模板示例仓库。Rancher 的示例位于此 GitHub 仓库中。
复刻仓库。
可选：通过编辑 values.yaml 文件来编辑集群选项。有关编辑文件的帮助，请参阅集群模板的 Helm Chart 自述文件。
将 Chart 仓库添加到 Rancher。点击 ☰ > 集群管理。
转到 local 集群并单击 Explore。
在左侧导航栏中，单击 Apps > Chart Repositories。
点击创建。
输入集群模板仓库的名称。
点击包含 Helm Chart 定义的 Git 仓库。
在 Git 仓库 URL字段，输入仓库的 URL，例如，https://github.com/rancher/cluster-template-examples.git。
在 Git 分支字段，输入要用作模板源的分支。Rancher 的示例仓库使用了 main 分支。
点击创建。

结果：集群模板可从 Rancher local 集群中的 Apps 获得。现在，你可以使用模板来部署集群。

受限管理员访问：

如果你是受限管理员并且无权访问 local 集群，你仍然可以添加新的 RKE2 模板并管理集群仓库。要导航到 Chart 仓库，请在左侧导航栏单击 ☰ > 集群管理 > 高级选项 > 仓库。你将绕过上述步骤 1 - 6，然后继续按照步骤 7 - 12 创建集群模板。

先决条件：

你需要获得配置新 Kubernetes 集群的权限。
你将需要云凭证来使用模板配置基础设施。
为了以创建新集群的形式显示，集群模板的 Helm Chart 必须具有 catalog.cattle.io/type: cluster-template 注释。

结果：在 Rancher 配置新集群后，你可以像管理其他 Rancher 启动的 Kubernetes 集群一样管理该新集群。如果集群模板有可供用户选择的选项，你可以通过 UI 配置这些选项。

如果集群所用的模板有了新版本，你可以使用 Apps > Installed Apps 页面中的模板更新集群。

先决条件：

你需要获得配置新 Kubernetes 集群的权限。
你将需要云凭证来使用模板配置基础设施。
为了以创建新集群的形式显示，集群模板的 Helm Chart 必须具有 catalog.cattle.io/type:cluster-template 注释。
为了将模板用作持续交付/GitOps 的一部分，集群模板需要部署在本地集群的 fleet-local 命名空间中。
所有值都必须在模板的 values.yaml 中设置。
Fleet 仓库必须遵循此处的指南。对于 RKE2 集群模板，则必须把 fleet.yaml 文件添加到仓库。

结果：Rancher 配置好新集群后，集群由 Fleet 管理。

结果：集群模板已卸载。此操作不会影响使用集群模板创建的现有集群。

能够访问 local 集群的管理员还可以前往 Apps > Installed Apps 页面，通过集群模板来移除已部署的集群。

集群模板非常灵活，可用于配置以下所有选项：

有关如何配置模板的详细信息，请参阅集群模板的 Helm Chart README 文件。