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

创建和修改 RKE 模板

危险

Rancher Kubernetes Engine (RKE/RKE1) will reach end of life on July 31, 2025. Rancher 2.12.0 and later will no longer support provisioning or managing downstream RKE1 clusters. We recommend replatforming RKE1 clusters to RKE2 to ensure continued support and security updates. Learn more about the transition here.

本节介绍如何管理 RKE 模板和修订版。你可以从 RKE1 配置 > RKE 模板下的集群管理视图创建、共享、更新和删除模板。

模板更新通过修订系统处理。当模板所有者想要更改或更新模板时，他们会创建模板的新版本。单个修订无法编辑。但是，如果你想防止使用修订来创建新集群，你可以禁用它。

你可以使用两种方式来使用模板修订：创建新集群，或升级使用较早版本的模板创建的集群。模板创建者可以设置默认修订版，但是在最终用户创建集群时，他们可以选择任何模板以及可供使用的任何模板修订版。使用指定的修订版创建集群后，就无法将其更改为另一个模板，但是可以将集群升级为同一模板的较新的可用修订版。

模板所有者对模板修订版具有完全控制权，并且可以创建新的修订版来更新模板，删除或禁用不应被用于创建集群的修订版，和设置默认的模板修订版。

先决条件​

如果你具有创建 RKE 模板权限，则可以创建 RKE 模板，该权限可由管理员授予。

如果你是模板的所有者，你可以修改、共享和删除模板。有关如何成为模板所有者的详细信息，请参阅共享模板所有权文档。

创建模板​

  1. 在左上角，单击 ☰ > 集群管理。
  2. 单击 RKE1 配置 > 节点模板。
  3. 单击添加模板。
  4. 输入模板的名称。Rancher 已经为模板的第一个版本自动生成了名称，该版本与该模板一起创建。
  5. 可选：通过将用户添加为成员，来与其他用户或组共享模板。你还可以将模板公开，从而与 Rancher 中的所有人共享。
  6. 然后按照屏幕上的表格将集群配置参数保存为模板修订的一部分。可以将修订标记为此模板的默认值。

结果：配置了具有一个修订版的 RKE 模板。你可以稍后在配置 Rancher 启动的集群时使用此 RKE 模板修订版。通过 RKE 模板管理集群后，集群无法解除与模板的绑定，并且无法取消选中使用现有 RKE 模板和修订版。

更新模板​

更新 RKE 模板相当于创建现有模板的修订版。使用旧版本模板创建的集群可以进行更新，从而匹配新版本。

你不能编辑单个修订。由于你无法编辑模板的单个修订，为了防止使用某个修订，你可以禁用该修订版。

创建新模板修订时，使用旧模板修订的集群不受影响。

  1. 在左上角，单击 ☰ > 集群管理。
  2. 在左侧导航栏，单击 RKE1 配置 > RKE 模板。
  3. 转到要编辑的模板，然后单击 ⋮ > 编辑。
  4. 编辑所需信息并单击保存。
  5. 可选：你可以更改此模板的默认修订版，也可以更改共享对象。

结果：模板已更新。要将其应用到使用旧版本模板的集群，请参阅升级集群以使用新的模板修订版。

删除模板​

当不再需要为任何集群使用某个 RKE 模板时，可以将其删除。

  1. 在左上角，单击 ☰ > 集群管理。
  2. 单击 RKE1 配置 > RKE 模板。
  3. 转到要删除的 RKE 模板，然后单击 ⋮ > 删除。
  4. 确认删除。

结果：模板被删除。

基于默认版创建新修订版​

你可以复制默认模板修订版并快速更新其设置，而无需从头开始创建新修订版。克隆模板为你省去了重新输入集群创建所需的访问密钥和其他参数的麻烦。

  1. 在左上角，单击 ☰ > 集群管理。
  2. 在左侧导航栏，单击 RKE1 配置 > RKE 模板。
  3. 转到要克隆的 RKE 模板，然后单击 ⋮ > 基于默认版创建新修订版。
  4. 填写表单的其余部分来创建新修订。

结果：克隆并配置了 RKE 模板修订版。

基于克隆版创建新修订版​

通过用户设置创建新的 RKE 模板修订版时，可以克隆现有修订版并快速更新其设置，而无需从头开始创建新的修订版。克隆模板修订省去了重新输入集群参数的麻烦。

  1. 在左上角，单击 ☰ > 集群管理。
  2. 在 RKE1 配置下，单击 RKE 模板。
  3. 转到要克隆的模板修订。然后选择 ⋮ > 克隆修订版。
  4. 填写表单的其余部分。

结果：克隆并配置了 RKE 模板修订版。你可以在配置集群时使用 RKE 模板修订。任何使用此 RKE 模板的现有集群都可以升级到此新版本。

禁用模板修订版​

当你不需要将 RKE 模板修订版本用于创建新集群时，可以禁用模板修订版。你也可以重新启用禁用了的修订版。

如果没有任何集群使用该修订，你可以禁用该修订。

  1. 在左上角，单击 ☰ > 集群管理。
  2. 在左侧导航栏，单击 RKE1 配置 > RKE 模板。
  3. 转到要禁用的模板修订版。然后选择 ⋮ > 禁用。

结果：RKE 模板修订版不能用于创建新集群。

重新启用禁用的模板修订版​

如果要使用已禁用的 RKE 模板修订版来创建新集群，你可以重新启用该修订版。

  1. 在左上角，单击 ☰ > 集群管理。
  2. 在 RKE1 配置下，单击 RKE 模板。
  3. 转到要重新启用的模板修订。然后选择 ⋮ > 启用。

结果：RKE 模板修订版可用于创建新集群。

将模板修订版设置为默认​

当最终用户使用 RKE 模板创建集群时，他们可以选择使用哪个版本来创建集群。你可以配置默认使用的版本。

要将 RKE 模板修订版设置为默认：

  1. 在左上角，单击 ☰ > 集群管理。
  2. 在左侧导航栏，单击 RKE1 配置 > RKE 模板。
  3. 转到要设为默认的 RKE 模板修订版，然后单击 ⋮ > 设为默认配置。

结果：使用模板创建集群时，RKE 模板修订版将用作默认选项。

删除模板修订版​

你可以删除模板的所有修订（默认修订除外）。

要永久删除修订版：

  1. 在左上角，单击 ☰ > 集群管理。
  2. 在左侧导航栏，单击 RKE1 配置 > RKE 模板。
  3. 转到要删除的 RKE 模板修订版，然后单击 ⋮ > 删除。

结果：RKE 模板修订版被删除。

升级集群以使用新的模板修订版​

备注

本部分假设你已经有一个集群，该集群应用了 RKE 模板。

本部分还假设你已更新了集群使用的模板，以便可以使用新的模板修订版。

要将集群升级到使用新的模板修订版：

  1. 在左上角，单击 ☰ > 集群管理。
  2. 转到要升级的集群，然后单击 ⋮ > 编辑配置。
  3. 在集群选项中，单击模板修订版的下拉菜单，然后选择新的模板修订版。
  4. 单击保存。

结果：集群已升级为使用新模板修订版中定义的设置。

将正在运行的集群导出到新的 RKE 模板和修订版​

你可以将现有集群的设置保存为 RKE 模板。

这将把集群的设置导出为新的 RKE 模板，并且将集群绑定到该模板。然后，只有更新了模板并且集群升级到使用更新版本的模板时，集群才能改变。

要将现有集群转换为使用 RKE 模板：

  1. 在左上角，单击 ☰ > 集群管理。
  2. 转到将被转换为使用 RKE 模板的集群，然后 ⋮ > 保存为 RKE 模板。
  3. 在出现的表单中输入 RKE 模板的名称，然后单击创建。

结果：