管理节点 IP 地址

本文档提供了有关 Google Distributed Cloud 中管理员集群和用户集群所需的 IP 地址数量的指导。

DHCP 或静态

如果您的网络具有 DHCP 服务器,则可以配置管理员集群或用户集群,使得它可以从 DHCP 服务器获取其工作器节点的 IP 地址。在集群配置文件中,将 network.ipMode.type 设置为 "dhcp"

如果您希望为集群指定静态 IP 地址,请将 network.ipMode.type 设置为“static”。

管理员集群需要多少个 IP 地址?

高可用性 (HA) 管理集群需要有三个可用于控制平面节点的 IP 地址。

管理员集群可管理一个或多个用户集群。如果为用户集群启用了 Controlplane V2,则用户集群控制平面节点将在用户集群中运行。启用了 Controlplane V2 的用户集群不会影响管理员集群所需的 IP 地址数量。

如果未为用户集群启用 Controlplane V2,则用户集群的控制平面会在管理员集群中的一个或多个节点上运行 (kubeception)。在使用 kubeception 的情况下,管理员集群还需要以下各项的 IP 地址:

  • 对于每个高可用性用户集群,管理员集群需要三个节点来运行用户集群的控制平面

  • 对于每个非高可用性用户集群,管理员集群需要一个节点来运行该用户集群的控制平面

    在未启用 Controlplane V2 时添加用户集群之前,请确保您有足够的 IP 地址可供管理员集群用于用户集群控制平面节点。如果您使用的是 DHCP,请确保 DHCP 服务器能够提供其他 IP 地址。

示例

说明 IP 地址数量
用于管理 Controlplane V2 用户集群的高可用性管理员集群
3 个控制平面节点

3
用于管理高可用性 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:用户集群配置文件的路径