复制集群

概述

如果您在 Rancher 中有已经创建了一个集群，并希望用这个集群作为模板，创建其他集群，您可以使用 Rancher CLI 复制该集群的配置，对其进行编辑，快速创建集群。

Rancher 支持复制的集群类型如下表所示：

集群类型是否支持复制
节点运行在基础设施供应商上的集群是
托管的 Kubernetes 集群是
自定义集群是
导入的集群否
警告

复制集群的功能适用于创建多个具有相似参数的集群，该功能的最终目的是简化创建集群的过程，减少用户在创建多个参数类似的集群的过程中所面临的重复工作。因此，我们建议仅编辑本文档中明确列出的值，编辑其他值可能会使配置文件无效，导致集群部署失败。如果您需要创建的多个集群中包含的参数差异较大，建议您参考“创建集群”章节的操作步骤，重头开始创建集群，而不是使用复制集群的功能创建集群。

先决条件

导出集群配置

首先使用 Rancher CLI 导出要复制的集群配置。

  1. 打开终端，然后将目录更改为 Rancher CLI 二进制文件 rancher 的位置。

  2. 输入以下命令以列出 Rancher 管理的集群。

    1. ./rancher cluster ls

    Copy

  3. 找到要复制的集群，然后将其资源 ID 或 NAME 复制到剪贴板。从这一点开始，我们统一将资源 ID 或 NAME 为 <RESOURCE_ID>占位符代替。

  4. 输入以下命令以导出集群的配置，请将<RESOURCE_ID>替换为真实的资源 ID。

    1. ./rancher clusters export <RESOURCE_ID>

    Copy

    步骤结果： 复制输出到终端的集群 YAML。

  5. 将 YAML 复制到剪贴板，粘贴到新文件中。将文件另存为 cluster-template.yml或其他任何名称，只要扩展名为 .yml 即可。

修改集群配置

使用您喜欢的文本编辑器为复制的集群修改cluster-template.yml中的集群配置。

注意：从 Rancher v2.3.0 开始，集群配置指令必须嵌套在cluster.yml中的rancher_kubernetes_engine_config配置下。有关更多信息，请参阅Rancher v2.3.0 +中的配置文件结构。

  1. 在您常用的文本编辑器中打开cluster-template.yml（或任何您命名的配置）。

    警告： 仅编辑下面明确指定的集群配置值。此文件中列出的许多值用于配置复制的集群，并且编辑它们的值可能会使集群创建中断。

  2. 如下例所示，在<CLUSTER_NAME>占位符处，用唯一的名称（<CLUSTER_NAME>）替换原始集群的名称，集群名称不可重复。

    1. Version: v3
    3. clusters:
    5.   <CLUSTER_NAME>: # 输入唯一的集群名称
    7.   dockerRootDir: /var/lib/docker
    9.   enableNetworkPolicy: false
    11.   rancherKubernetesEngineConfig:
    13.   addonJobTimeout: 30
    15.   authentication:
    17.     strategy: x509
    19.   authorization: {}
    21.   bastionHost: {}
    23.   cloudProvider: {}
    25.   ignoreDockerVersion: true

    Copy

  3. 对于每个nodePools部分，在 <NODEPOOL_NAME> 占位符处用唯一名称替换原始节点池名称，节点名称不可重复。

    1. nodePools:
    3.   <NODEPOOL_NAME>:
    5.   clusterId: do
    7.   controlPlane: true
    9.   etcd: true
    11.   hostnamePrefix: mark-do
    13.   nodeTemplateId: do
    15.   quantity: 1
    17.   worker: true

    Copy

  4. 完成后，保存并关闭配置。

启动复制集群

将cluster-template.yml移到与 Rancher CLI 二进制文件相同的目录中。然后运行以下命令：

  1. ./rancher up --file cluster-template.yml

Copy

结果：您复制的集群开始配置。输入./rancher cluster ls进行确认。您还可以登录 Rancher UI 并打开全局视图以查看新创建的集群的进度。