添加新节点

KubeSphere 使用一段时间之后,由于工作负载不断增加,您可能需要水平扩展集群。自 KubeSphere v3.0.0 起,您可以使用全新的安装程序 KubeKey 将新节点添加到集群。从根本上说,该操作是基于 Kubelet 的注册机制。换言之,新节点将自动加入现有的 Kubernetes 集群。KubeSphere 支持混合环境,这意味着新添加的主机操作系统可以是 CentOS 或者 Ubuntu。

本教程演示了如何将新节点添加到单节点集群。若要水平扩展多节点集群,操作步骤基本相同。

准备工作

添加工作节点

  1. 使用 KubeKey 检索集群信息。以下命令会创建配置文件 (sample.yaml)。

    1. ./kk create config --from-cluster

    备注

    如果您的机器上已有配置文件,就可以跳过此步骤。例如,若要将节点添加到由 KubeKey 设置的多节点集群,如果您没有删除该集群,则可能仍拥有该配置文件。

  2. 在配置文件中,将新节点的信息放在 hostsroleGroups 之下。该示例添加了两个新节点(即 node1node2)。这里的 master1 是现有节点。

    1. ···
    2. spec:
    3. hosts:
    4. - {name: master1, address: 192.168.0.3, internalAddress: 192.168.0.3, user: root, password: Qcloud@123}
    5. - {name: node1, address: 192.168.0.4, internalAddress: 192.168.0.4, user: root, password: Qcloud@123}
    6. - {name: node2, address: 192.168.0.5, internalAddress: 192.168.0.5, user: root, password: Qcloud@123}
    7. roleGroups:
    8. etcd:
    9. - master1
    10. control-plane:
    11. - master1
    12. worker:
    13. - node1
    14. - node2
    15. ···

    备注

    • 有关更多配置文件的信息,请参见编辑配置文件

    • 添加新节点时,请勿修改现有节点的主机名。

    • 用自己的主机名替换示例中的主机名。

  3. 执行以下命令:

    1. ./kk add nodes -f sample.yaml
  4. 安装完成后,您将能够在 KubeSphere 的控制台上查看新节点及其信息。在集群管理页面,选择左侧菜单节点下的集群节点,或者执行命令 kubectl get node 以检查更改。

    1. $ kubectl get node
    2. NAME STATUS ROLES AGE VERSION
    3. master1 Ready master,worker 20d v1.17.9
    4. node1 Ready worker 31h v1.17.9
    5. node2 Ready worker 31h v1.17.9

添加主节点以实现高可用

添加主节点的步骤与添加工作节点的步骤大体一致,不过您需要为集群配置负载均衡器。您可以使用任何云负载均衡器或者硬件负载均衡器(例如 F5)。另外,Keepalived 和 HAproxy、或者 Nginx 也是创建高可用集群的替代方案。

  1. 使用 KubeKey 创建配置文件。

    1. ./kk create config --from-cluster
  2. 打开文件,可以看到一些字段预先填充了值。将新节点和负载均衡器的信息添加到文件中。以下示例供您参考:

    1. apiVersion: kubekey.kubesphere.io/v1alpha1
    2. kind: Cluster
    3. metadata:
    4. name: sample
    5. spec:
    6. hosts:
    7. # You should complete the ssh information of the hosts
    8. - {name: master1, address: 172.16.0.2, internalAddress: 172.16.0.2, user: root, password: Testing123}
    9. - {name: master2, address: 172.16.0.5, internalAddress: 172.16.0.5, user: root, password: Testing123}
    10. - {name: master3, address: 172.16.0.6, internalAddress: 172.16.0.6, user: root, password: Testing123}
    11. - {name: worker1, address: 172.16.0.3, internalAddress: 172.16.0.3, user: root, password: Testing123}
    12. - {name: worker2, address: 172.16.0.4, internalAddress: 172.16.0.4, user: root, password: Testing123}
    13. - {name: worker3, address: 172.16.0.7, internalAddress: 172.16.0.7, user: root, password: Testing123}
    14. roleGroups:
    15. etcd:
    16. - master1
    17. - master2
    18. - master3
    19. control-plane:
    20. - master1
    21. - master2
    22. - master3
    23. worker:
    24. - worker1
    25. - worker2
    26. - worker3
    27. controlPlaneEndpoint:
    28. # If loadbalancer is used, 'address' should be set to loadbalancer's ip.
    29. domain: lb.kubesphere.local
    30. address: 172.16.0.253
    31. port: 6443
    32. kubernetes:
    33. version: v1.22.12
    34. imageRepo: kubesphere
    35. clusterName: cluster.local
    36. proxyMode: ipvs
    37. masqueradeAll: false
    38. maxPods: 110
    39. nodeCidrMaskSize: 24
    40. network:
    41. plugin: calico
    42. kubePodsCIDR: 10.233.64.0/18
    43. kubeServiceCIDR: 10.233.0.0/18
    44. registry:
    45. privateRegistry: ""
  3. 请注意 controlPlaneEndpoint 字段。

    1. controlPlaneEndpoint:
    2. # If you use a load balancer, the address should be set to the load balancer's ip.
    3. domain: lb.kubesphere.local
    4. address: 172.16.0.253
    5. port: 6443
    • 负载均衡器的域名默认为 lb.kubesphere.local,用于内部访问。您可以按需进行更改。
    • 大多数情况下,您需要为 address 字段提供负载均衡器的私有 IP 地址。然而,不同的云厂商可能为负载均衡器进行不同的配置。例如,如果您在阿里云上配置服务器负载均衡 (SLB),该平台会为 SLB 分配一个公共 IP 地址,这意味着您需要为 address 字段指定公共 IP 地址。
    • port 字段指代 api-server 的端口。
  4. 保存文件并执行以下命令以应用配置。

    1. ./kk add nodes -f sample.yaml