管理节点 IP 地址

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

DHCP 或静态

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

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

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

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

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

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

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

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

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

示例

说明 IP 地址数量
负责管理控制平面 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 块文件不包含用户集群的控制平面节点的地址。如果用户集群启用了控制平面 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:用户集群配置文件的路径