跳到主要内容
版本：v2.7

集群模板

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

概述​

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

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

Kubernetes 发行版​

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

版本控制​

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

RKE2 集群模板​

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

向 Rancher 添加集群模板​

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

先决条件：
  • 你需要有在本地 Kubernetes 集群上安装 Helm Chart 的权限。
  • 为了使 Chart 以创建新集群的形式出现，Chart 必须具有注释 catalog.cattle.io/type: cluster-template。
  1. 转到集群模板示例仓库。Rancher 的示例位于此 GitHub 仓库中。
  2. 复刻仓库。
  3. 可选：通过编辑 values.yaml 文件来编辑集群选项。有关编辑文件的帮助，请参阅集群模板的 Helm Chart 自述文件。
  4. 将 Chart 仓库添加到 Rancher。点击 ☰ > 集群管理。
  5. 转到 local 集群并单击 Explore。
  6. 在左侧导航栏中，单击 Apps > Chart Repositories。
  7. 点击创建。
  8. 输入集群模板仓库的名称。
  9. 点击包含 Helm Chart 定义的 Git 仓库。
  10. 在 Git 仓库 URL字段，输入仓库的 URL，例如，https://github.com/rancher/cluster-template-examples.git。
  11. 在 Git 分支字段，输入要用作模板源的分支。Rancher 的示例仓库使用了 main 分支。
  12. 点击创建。

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

受限管理员访问：

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

使用集群模板创建集群​

先决条件：
  • 你需要获得配置新 Kubernetes 集群的权限。
  • 你将需要云凭证来使用模板配置基础设施。
  • 为了以创建新集群的形式显示，集群模板的 Helm Chart 必须具有 catalog.cattle.io/type: cluster-template 注释。
  1. 点击 ☰ > 集群管理。
  2. 在集群页面，点击创建。
  3. 单击集群模板的名称。
  4. 完成 Helm Chart 的安装。

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

更新使用集群模板创建的集群​

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

使用 Fleet 从模板部署集群​

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

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

卸载集群模板​

  1. 点击 ☰ > 集群管理。
  2. 前往 local 集群并单击 Apps > Chart Repositories。
  3. 转到集群模板的 Chart 仓库，然后单击 ⋮ > 删除。
  4. 确认删除。

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

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

配置选项​

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

  • 节点配置
  • 节点池
  • 预先指定的云凭证
  • 启用/配置授权的集群端点，以在不使用 Rancher 作为代理的情况下获得对集群的 kubectl 访问权限
  • 安装 Rancher V2 monitoring
  • Kubernetes 版本
  • 分配集群成员
  • 配置基础设施，例如 AWS VPC/子网或 vSphere 数据中心
  • 云提供商选项
  • Pod 安全选项
  • 网络提供商
  • Ingress Controller
  • 网络安全配置
  • 网络插件
  • 私有镜像仓库 URL 和凭证
  • 附加组件
  • Kubernetes 选项，包括 kube-api、kube-controller、kubelet 和服务等 Kubernetes 组件的配置

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