diff --git a/content/zh/docs/installing-on-linux/cluster-operation/add-edge-nodes.md b/content/zh/docs/installing-on-linux/cluster-operation/add-edge-nodes.md new file mode 100644 index 000000000..0c50720b2 --- /dev/null +++ b/content/zh/docs/installing-on-linux/cluster-operation/add-edge-nodes.md @@ -0,0 +1,166 @@ +--- +title: "添加边缘节点" +keywords: 'Kubernetes, KubeSphere, KubeEdge' +description: '将边缘节点添加到群集。' +linkTitle: "添加边缘节点" +weight: 3630 +--- + +KubeSphere 利用 [KubeEdge](https://kubeedge.io/zh/) 将原生容器化应用程序编排功能扩展到边缘的主机。KubeEdge 拥有单独的云端和边端核心模块，提供完整的边缘计算解决方案，但安装过程可能较为繁琐。 + +![kubeedge_arch](/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/kubeedge_arch.png) + +{{< notice note >}} + +有关 KubeEdge 不同组件的更多信息，请参见 [KubeEdge 文档](https://docs.kubeedge.io/zh/docs/kubeedge/#components)。 + +{{}} + +边缘节点加入集群后，原生 KubeEdge 云组件要求手动配置 iptables，以便您使用 `kubectl logs` 和 `kubectl exec` 等命令。对此，KubeSphere 能够提供一种高效便捷的方法将边缘节点添加到 Kubernetes 集群。它使用所支持的组件来自动配置 iptables（例如，EdgeWatcher）。 + +![edge-watcher](/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-watcher.png) + +本教程演示如何将边缘节点添加到集群。 + +## 准备工作 + +- 您需要启用 [KubeEdge](../../../pluggable-components/kubeedge/)。 +- 您有一个可用节点作为边缘节点，该节点可以运行 Ubuntu（建议）或 CentOS。本教程以 Ubuntu 18.04 为例。 +- 与 Kubernetes 集群节点不同，边缘节点应部署在单独的网络中。 + +## 配置边缘节点 + +您需要在边缘节点上安装容器运行时并配置 EdgeMesh。 + +### 安装容器运行时 + +[KubeEdge](https://docs.kubeedge.io/zh/docs/) 支持多种容器运行时，包括 Docker、containerd、CRI-O 和 Virtlet。有关更多信息，请参见 [KubeEdge 文档](https://docs.kubeedge.io/zh/docs/advanced/cri/)。 + +### 配置 EdgeMesh + +执行以下步骤以在边缘节点上配置 [EdgeMesh](https://kubeedge.io/zh/docs/advanced/edgemesh/)。 + +1. 编辑 `/etc/nsswitch.conf`。 + + ```bash + vi /etc/nsswitch.conf + ``` + +2. 在该文件中添加以下内容。 + + ```bash + hosts: dns files mdns4_minimal [NOTFOUND=return] + ``` + +3. 保存文件并运行以下命令启用 IP 转发： + + ```bash + sudo echo "net.ipv4.ip_forward = 1" >> /etc/sysctl.conf + ``` + +4. 验证修改： + + ```bash + sudo sysctl -p | grep ip_forward + ``` + + 预期结果： + + ```bash + net.ipv4.ip_forward = 1 + ``` + +## 创建防火墙规则和端口转发规则 + +若要确保边缘节点可以成功地与集群通信，您必须转发端口，以便外部流量进入您的网络。您可以根据下表将外网端口映射到相应的内网 IP 地址（主节点）和端口。此外，您还需要创建防火墙规则以允许流量进入这些端口（`10000` 至 `10004`）。 + +| 字段 | 外网端口 | 字段 | 内网端口 | +| ------------------- | -------- | ----------------------- | -------- | +| `cloudhubPort` | `10000` | `cloudhubNodePort` | `30000` | +| `cloudhubQuicPort` | `10001` | `cloudhubQuicNodePort` | `30001` | +| `cloudhubHttpsPort` | `10002` | `cloudhubHttpsNodePort` | `30002` | +| `cloudstreamPort` | `10003` | `cloudstreamNodePort` | `30003` | +| `tunnelPort` | `10004` | `tunnelNodePort` | `30004` | + +## 添加边缘节点 + +1. 使用 `admin` 用户登录控制台，点击左上角的**平台管理**。 + +2. 选择**集群管理**，然后导航至**节点管理**下的**边缘节点**。 + + {{< notice note >}} + + 如果已经启用[多集群管理](../../../multicluster-management/)，则需要首先选择一个集群。 + + {{}} + +3. 点击**添加节点**。在出现的对话框中，设置边缘节点的节点名称并输入其内网 IP 地址。点击**验证**以继续。 + + {{< notice note >}} + + - 内网 IP 地址仅用于节点间通信，您不一定要使用边缘节点的真实内网 IP 地址。只要 IP 地址验证成功，您就可以使用该 IP 地址。 + - 建议您勾选方框添加默认污点。 + + {{}} + +4. 复制**添加命令**下自动创建的命令，并在您的边缘节点上运行该命令。 + + {{< notice note >}} + + 在运行该命令前，请确保您的边缘节点上已安装 `wget`。 + + {{}} + + ![edge-node1](/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-node1.png) + +5. 关闭对话框，刷新页面，您将看到边缘节点显示在列表中。 + + ![edge-node-2](/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-node-2.png) + + {{< notice note >}} + + 添加边缘节点后，如果在**边缘节点**页面查看不到 CPU 和内存资源使用情况，请确保您的集群中已安装 [Metrics Server](../../../pluggable-components/metrics-server/) 0.4.1 或以上版本。 + + {{}} + +## 移除边缘节点 + +移除边缘节点之前，请删除在该节点上运行的全部工作负载。 + +1. 在边缘节点上运行以下命令： + + ```bash + ./keadm reset + ``` + + ``` + apt remove mosquitto + ``` + + ```bash + rm -rf /var/lib/kubeedge /var/lib/edged /etc/kubeedge/ca /etc/kubeedge/certs + ``` + + {{< notice note >}} + + 如果无法删除 tmpfs 挂载的文件夹，请重启节点或先取消挂载该文件夹。 + + {{}} + +2. 运行以下命令从集群中移除边缘节点： + + ```bash + kubectl delete node + ``` + +3. 如需从集群中卸载 KubeEdge，运行以下命令： + + ```bash + helm uninstall kubeedge -n kubeedge + ``` + + {{< notice note >}} + + 卸载完成后，您将无法为集群添加边缘节点。 + + {{}} diff --git a/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-node-2.png b/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-node-2.png new file mode 100644 index 000000000..e101f6020 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-node-2.png differ diff --git a/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-node1.png b/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-node1.png new file mode 100644 index 000000000..c9cccd624 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-node1.png differ diff --git a/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-watcher.png b/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-watcher.png new file mode 100644 index 000000000..2cb603798 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/edge-watcher.png differ diff --git a/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/kubeedge_arch.png b/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/kubeedge_arch.png new file mode 100644 index 000000000..5f6aeae68 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-linux/add-and-delete-nodes/add-edge-nodes/kubeedge_arch.png differ