本文档提供了有关 Google Distributed Cloud 中的管理员集群和用户集群所需的 IP 地址数量的指导。
DHCP 或静态
如果您的网络具有 DHCP 服务器，您可以配置管理员集群或用户集群，使其从 DHCP 服务器获取其工作器节点的 IP 地址。在集群配置文件中，将 network.ipMode.type 设置为 "dhcp"。
如果您希望为集群指定静态 IP 地址，请将 network.ipMode.type 设置为“static”。
管理员集群需要多少个 IP 地址？
高可用性 (HA) 管理员集群需要有三个 IP 地址可用于控制平面节点。
一个管理员集群管理一个或多个用户集群。如果为用户集群启用了控制平面 V2，则用户集群控制平面节点会在用户集群中运行。启用了 Controlplane V2 的用户集群不会影响管理员集群所需的 IP 地址数量。
如果未为用户集群启用 Controlplane V2，则用户集群的控制平面会在管理员集群 (kubeception) 中的一个或多个节点上运行。在 kubeception 中，管理员集群还需要用于执行以下操作的 IP 地址：
对于每个高可用性用户集群，管理员集群都需要三个节点来为用户集群运行控制平面
对于每个非高可用性用户集群，管理员集群都需要一个节点来运行用户集群的控制平面
在未启用 Controlplane V2 的情况下添加用户集群之前，请确保您有足够的 IP 地址供管理员集群用于用户集群控制平面节点。如果您使用的是 DHCP，请确保您的 DHCP 服务器能够提供其他 IP 地址。
示例：
| 说明 | IP 地址数量 |
|---|---|
|
用于管理控制平面 V2 用户集群的高可用性管理员集群 3 个控制平面节点 |
3 |
|
管理 HA kubeception 用户集群的高可用性管理员集群 3 个控制平面节点 + 3 个用户集群控制平面节点 |
6 |
用户集群需要多少个 IP 地址？
如果启用了 Controlplane V2（默认情况下），一个或三个节点用于在用户集群上运行控制平面：
一个节点用于非高可用性（非 HA）用户集群
三个节点用于 HA 用户集群
每个工作器节点一个 IP 地址（运行您的工作负载的节点）
一个额外的 IP 地址，用作升级、更新和自动修复期间的临时节点。
在启用 Controlplane V2 后，向用户集群添加更多工作器节点之前，确保您有足够的 IP 地址可供用户集群用于控制平面节点。如果您使用的是 DHCP，请确保 DHCP 服务器能够提供其他 IP 地址。
示例：
| 说明 | IP 地址数量 |
|---|---|
|
非 HA 用户集群，Controlplane V2 3 个工作器节点 + 1 个控制平面节点 + 1 个额外节点 |
5 |
|
HA 用户集群，Controlplane V2 3 个工作器节点 + 3 个控制平面节点 + 1 个额外节点 |
7 |
|
用户集群，kubeception 3 个工作器节点 + 1 个额外节点 |
4 |
管理员集群的静态 IP 地址
本部分介绍如何管理管理员集群的静态 IP 地址。
您必须为管理员集群控制平面节点指定三个 IP 地址。在管理员集群配置文件的 network.controlPlaneIPBlock 部分中指定这些地址。
如果您打算创建 kubeception 用户集群，则必须指定要用于用户集群的控制平面节点的 IP 地址。在 IP 块文件中指定这些地址。然后，在管理员集群配置文件的 network.ipMode.ipBlockFilePath 字段中提供 IP 块文件的路径。
例如，假设您打算创建两个 kubeception 用户集群：一个高可用性集群和一个非高可用性集群。高可用性用户集群在管理员集群中有三个控制平面节点，非高可用性用户集群在管理员集群中有一个控制平面节点。因此，您需要指定四个 IP 地址以及一个要在更新期间使用的额外 IP 地址。
以下是一个具有五个 IP 地址的 IP 地址块文件示例：
blocks:
- netmask: 255.255.255.0
gateway: 172.16.20.1
ips:
- ip: 172.16.20.50
hostname: admin-vm-1
- ip: 172.16.20.51
hostname: admin-vm-2
- ip: 172.16.20.52
hostname: admin-vm-3
- ip: 172.16.20.53
hostname: admin-vm-4
- ip: 172.16.20.54
hostname: admin-vm-5
将 IP 地址添加到管理员集群
如需为管理员集群中的节点提供更多的 IP 地址，请将地址添加到 IP 地址块文件中，然后运行以下命令来更新管理员集群：
gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG--config ADMIN_CLUSTER_CONFIG
请替换以下内容：
ADMIN_CLUSTER_KUBECONFIG：管理员集群 kubeconfig 文件的路径
ADMIN_CLUSTER_CONFIG：管理员用户集群配置文件的路径
用户集群的静态 IP 地址
本部分介绍如何管理用户集群的静态 IP 地址。
确定可用于用户集群节点的 IP 地址
用户集群的 IP 地址块文件在用户集群配置文件中列为 network.ipMode.ipBlockFilePath 的值。在 IP 块文件中，您可以看到可用于用户集群中工作器节点的 IP 地址。
例如，以下 IP 地址块文件具有四个 IP 地址：
blocks:
- netmask: 255.255.255.0
gateway: 172.16.20.1
ips:
- ip: 172.16.20.55
hostname: user-vm-1
- ip: 172.16.20.56
hostname: user-vm-2
- ip: 172.16.20.57
hostname: user-vm-3
- ip: 172.16.20.58
hostname: user-vm-4
IP 块文件不包含用户集群的控制平面节点的地址。如果用户集群启用了 Controlplane V2，则控制平面节点的 IP 地址位于用户集群配置文件的 network.controlPlaneIPBlock 部分中。否则，用户集群的控制平面节点的 IP 地址位于管理员集群的 IP 块文件中。
向用户集群添加 IP 地址
如需为用户集群中的节点提供更多的 IP 地址，请将地址添加到 IP 地址块文件中，然后运行以下命令来更新用户集群：
gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG--config USER_CLUSTER_CONFIG
请替换以下内容：
ADMIN_CLUSTER_KUBECONFIG：管理员集群 kubeconfig 文件的路径
USER_CLUSTER_CONFIG：用户集群配置文件的路径