From c73364fc4f39c8fbc3439cb15713d080eac3ccc1 Mon Sep 17 00:00:00 2001 From: serenashe Date: Mon, 15 Mar 2021 11:29:34 +0800 Subject: [PATCH] add-new-nodes zh reviewed (#1182) * add-new-nodes zh reviewed Signed-off-by: adakisme * remove-nodes doc zh modified Signed-off-by: adakisme --- .../cluster-operation/add-new-nodes.md | 3 +- .../cluster-operation/add-new-nodes.md | 185 +++++++++++++----- 2 files changed, 139 insertions(+), 49 deletions(-) diff --git a/content/en/docs/installing-on-linux/cluster-operation/add-new-nodes.md b/content/en/docs/installing-on-linux/cluster-operation/add-new-nodes.md index a0b58234d..684f9d1b3 100644 --- a/content/en/docs/installing-on-linux/cluster-operation/add-new-nodes.md +++ b/content/en/docs/installing-on-linux/cluster-operation/add-new-nodes.md @@ -152,4 +152,5 @@ The steps of adding master nodes are generally the same as adding worker nodes w ```bash ./kk add nodes -f sample.yaml - ``` \ No newline at end of file + ``` + diff --git a/content/zh/docs/installing-on-linux/cluster-operation/add-new-nodes.md b/content/zh/docs/installing-on-linux/cluster-operation/add-new-nodes.md index 69df45849..d6632821e 100644 --- a/content/zh/docs/installing-on-linux/cluster-operation/add-new-nodes.md +++ b/content/zh/docs/installing-on-linux/cluster-operation/add-new-nodes.md @@ -1,69 +1,158 @@ --- title: "添加新节点" -keywords: 'kubernetes, kubesphere, scale, add-nodes' -description: 'How to add new nodes in an existing cluster' - - +keywords: 'Kubernetes, KubeSphere, 水平扩缩, 添加节点' +description: '如何将新节点添加到现有集群' +linkTitle: "添加新节点" weight: 3410 --- -使用 KubeSphere 一段时间后，很可能随着工作负载的增加需要扩展集群。在这种情况下，KubeSphere 提供了一个添加新节点的脚本。原理上，该操作是基于 Kubelet 的注册机制，换句话说，新节点将自动加入现有的 Kubernetes 集群中。 +KubeSphere 使用一段时间之后，由于工作负载不断增加，您可能需要水平扩展集群。自 KubeSphere v3.0.0 起，您可以使用全新的安装程序 [KubeKey](https://github.com/kubesphere/kubekey) 将新节点添加到集群。从根本上说，该操作是基于 Kubelet 的注册机制。换言之，新节点将自动加入现有的 Kubernetes 集群。KubeSphere 支持混合环境，这意味着新添加的主机操作系统可以是 CentOS 或者 Ubuntu。 -{{< notice tip >}} +本教程演示了如何将新节点添加到单节点集群。若要水平扩展多节点集群，操作步骤基本相同。 -从 v3.0.0 起，全新的安装程序 [KubeKey](https://github.com/kubesphere/kubekey) 支持在一个单节点集群上伸缩主节点和工作节点。 +## 准备工作 -{{}} +- 您需要一个单节点集群。有关更多信息，请参见[在 Linux 上以 All-in-One 模式安装 KubeSphere](../../../quick-start/all-in-one-on-linux/)。 -### 步骤1：修改主机配置 +- 您需要已经[下载了 KubeKey](../../../installing-on-linux/introduction/multioverview/#步骤-2下载-kubekey)。 -KubeSphere 支持混合环境，即新添加的主机操作系统可以是 CentOS，也可以是 Ubuntu。准备好新机器后，在文件`config-sample.yaml`的`hosts`和`roleGroups`下添加有关新机器的信息。 +## 添加工作节点 -{{< notice warning >}} -添加新节点时，不允许修改原始节点（例如 master1）的主机名。 +1. 使用 KubeKey 检索集群信息。以下命令会创建配置文件 (`sample.yaml`)。 -{{}} + ```bash + ./kk create config --from-cluster + ``` -例如，如果您使用 [all-in-one](../../../quick-start/all-in-one-on-linux) 安装的单节点集群，现在想要为这个集群添加新节点 ，您可以先使用 KubeKey 创建配置文件。 + {{< notice note >}} -```bash -# Assume your original Kubernetes cluster is v1.17.9 -./kk create config --with-kubesphere v3.0.0 --with-kubernetes v1.17.9 -``` +如果您的机器上已有配置文件，就可以跳过此步骤。例如，若要将节点添加到由 KubeKey 设置的多节点群集，如果您没有删除该集群，则可能仍拥有该配置文件。 -以下部分以`root`用户为例，演示如何添加两个节点（即`node1`和`node2`），并假设第一台计算机的主机名是`master1`（用您的主机名替换以下主机名）。 +{{}} -```yaml -spec: - hosts: - - {name: master1, address: 192.168.0.3, internalAddress: 192.168.0.3, user: root, password: Qcloud@123} - - {name: node1, address: 192.168.0.4, internalAddress: 192.168.0.4, user: root, password: Qcloud@123} - - {name: node2, address: 192.168.0.5, internalAddress: 192.168.0.5, user: root, password: Qcloud@123} - roleGroups: - etcd: - - master1 - master: - - master1 - worker: - - node1 - - node2 -··· -``` +2. 在配置文件中，将新节点的信息放在 `hosts` 和 `roleGroups` 之下。该示例添加了两个新节点（即 `node1` 和 `node2`）。这里的 `master1` 是现有节点。 -### 步骤2：执行添加节点命令 + ```bash + ··· + spec: + hosts: + - {name: master1, address: 192.168.0.3, internalAddress: 192.168.0.3, user: root, password: Qcloud@123} + - {name: node1, address: 192.168.0.4, internalAddress: 192.168.0.4, user: root, password: Qcloud@123} + - {name: node2, address: 192.168.0.5, internalAddress: 192.168.0.5, user: root, password: Qcloud@123} + roleGroups: + etcd: + - master1 + master: + - master1 + worker: + - node1 + - node2 + ··· + ``` -执行以下命令： + {{< notice note >}} -```bash -./kk add nodes -f config-sample.yaml -``` +- 有关更多配置文件的信息，请参见[编辑配置文件](../../../installing-on-linux/introduction/multioverview/#2-编辑配置文件)。 -执行成功后，您将能够在 KubeSphere 控制台上查看新节点及其信息。从左侧菜单中选择**节点管理 → 集群节点**，或者使用`kubectl get node`命令也可以看到更改。 +- 添加新节点时，请勿修改现有节点的主机名。 + +- 用自己的主机名替换示例中的主机名。 + + {{}} + +3. 执行以下命令： + + ```bash + ./kk add nodes -f sample.yaml + ``` + +4. 安装完成后，您将能够在 KubeSphere 的控制台上查看新节点及其信息。在**集群管理**页面，选择左侧菜单**节点管理**下的**集群节点**，或者执行命令 `kubectl get node` 以检查更改。 + + ```bash + $ kubectl get node + NAME STATUS ROLES AGE VERSION + master1 Ready master,worker 20d v1.17.9 + node1 Ready worker 31h v1.17.9 + node2 Ready worker 31h v1.17.9 + ``` + +## 添加主节点以实现高可用 + +添加主节点的步骤与添加工作节点的步骤大体一致，不过您需要为集群配置负载均衡器。您可以使用任何云负载均衡器或者硬件负载均衡器（例如 F5）。另外，Keepalived 和 [HAproxy](https://www.haproxy.com/)、或者 Nginx 也是创建高可用集群的替代方案。 + +1. 使用 KubeKey 创建配置文件。 + + ``` + ./kk create config --from-cluster + ``` + +2. 打开文件，可以看到一些字段预先填充了值。将新节点和负载均衡器的信息添加到文件中。以下示例供您参考： + + ```yaml + apiVersion: kubekey.kubesphere.io/v1alpha1 + kind: Cluster + metadata: + name: sample + spec: + hosts: + # You should complete the ssh information of the hosts + - {name: master1, address: 172.16.0.2, internalAddress: 172.16.0.2, user: root, password: Testing123} + - {name: master2, address: 172.16.0.5, internalAddress: 172.16.0.5, user: root, password: Testing123} + - {name: master3, address: 172.16.0.6, internalAddress: 172.16.0.6, user: root, password: Testing123} + - {name: worker1, address: 172.16.0.3, internalAddress: 172.16.0.3, user: root, password: Testing123} + - {name: worker2, address: 172.16.0.4, internalAddress: 172.16.0.4, user: root, password: Testing123} + - {name: worker3, address: 172.16.0.7, internalAddress: 172.16.0.7, user: root, password: Testing123} + roleGroups: + etcd: + - master1 + - master2 + - master3 + master: + - master1 + - master2 + - master3 + worker: + - worker1 + - worker2 + - worker3 + controlPlaneEndpoint: + # If loadbalancer is used, 'address' should be set to loadbalancer's ip. + domain: lb.kubesphere.local + address: 172.16.0.253 + port: 6443 + kubernetes: + version: v1.17.9 + imageRepo: kubesphere + clusterName: cluster.local + proxyMode: ipvs + masqueradeAll: false + maxPods: 110 + nodeCidrMaskSize: 24 + network: + plugin: calico + kubePodsCIDR: 10.233.64.0/18 + kubeServiceCIDR: 10.233.0.0/18 + registry: + privateRegistry: "" + ``` + +3. 请注意 `controlPlaneEndpoint` 字段。 + + ```yaml + controlPlaneEndpoint: + # If you use a load balancer, the address should be set to the load balancer's ip. + domain: lb.kubesphere.local + address: 172.16.0.253 + port: 6443 + ``` + + - 负载均衡器的域名默认为 `lb.kubesphere.local`，用于内部访问。您可以按需进行更改。 + - 大多数情况下，您需要为 `address` 字段提供负载均衡器的**私有 IP 地址**。然而，不同的云厂商可能为负载均衡器进行不同的配置。例如，如果您在阿里云上配置服务器负载均衡 (SLB)，该平台会为 SLB 分配一个公共 IP 地址，这意味着您需要为 `address` 字段指定公共 IP 地址。 + - `port` 字段指代 `api-server` 的端口。 + +4. 保存文件并执行以下命令以应用配置。 + + ```bash + ./kk add nodes -f sample.yaml + ``` -```bash -$ kubectl get node -NAME STATUS ROLES AGE VERSION -master1 Ready master,worker 20d v1.17.9 -node1 Ready worker 31h v1.17.9 -node2 Ready worker 31h v1.17.9 -```