本文档采用自动化机器翻译技术翻译。 尽管我们力求提供准确的译文，但不对翻译内容的完整性、准确性或可靠性作出任何保证。 若出现任何内容不一致情况，请以原始 英文 版本为准，且原始英文版本为权威文本。

创建和修订 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. 指定该模板的名称。模板的第一个版本已自动生成名称，并与此模板一起创建。

  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 模板，并将集群绑定到该模板。结果是，只有在 模板被更新时，集群才能更改，并且集群需要升级以 <<_upgrading_a_cluster_to_use_a_new_template_revision,使用新版本的模板。

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

  1. 在左上角，单击*☰ > 集群管理*。

  2. 转到将被转换为使用 RKE 模板的集群，然后 ⋮ > 保存为 RKE 模板。

  3. 在出现的表单中输入 RKE 模板的名称，然后点击 创建。

结果：