IP 區塊檔案

IP 區塊檔案會列出 Google Distributed Cloud 軟體專用 VMware 叢集中節點機器的 IP 位址和主機名稱 (選用),以及網路的網路遮罩和閘道。如果叢集節點有靜態 IP 位址,例如靜態 IP 模式下的 worker 節點,或使用拓撲網域的叢集控制層節點,則會使用 IP 區塊檔案。請為每個叢集建立獨立的 IP 區塊檔案,並在管理員或使用者叢集設定檔的 network.ipMode.ipBlockFilePath 欄位中指定絕對或相對路徑。

關於 IP 封鎖檔案

在下列情況下,請使用 IP 封鎖檔案列出 IP 位址,並視需要列出主機名稱:

  • 使用者叢集:

    • 如果使用者叢集設定檔中的 network.ipMode.type 設為 "static",請在使用者叢集 IP 區塊檔案中列出 worker 節點的 IP 位址。

    • 如果在管理員叢集設定檔中設定 infraConfigFilePath (啟用拓撲網域),請在使用者叢集 IP 區塊檔案中列出控制層節點的 IP 位址。即使 worker 節點使用 DHCP,控制層節點的 IP 位址一律為靜態 IP 位址。

  • 管理員叢集:

    • 如果在管理員叢集設定檔中設定 infraConfigFilePath (啟用拓撲網域),請在管理員叢集 IP 區塊檔案中列出控制層節點的 IP 位址。

    • 1.16 以下非高可用性管理員叢集:在管理員叢集 IP 區塊檔案中,列出控制層節點和外掛程式節點的 IP 位址。

    • 1.16 以下版本的高可用性管理員叢集:在 IP 區塊檔案中列出外掛程式節點的 IP 位址。

    • 1.29 以下版本的 kubeception 使用者叢集:在管理員叢集 IP 區塊檔案中,列出使用者叢集控制層節點的 IP 位址。

範本

填寫 IP 封鎖檔案中的欄位

以下各節將說明 IP 封鎖檔案中的欄位。

blocks

物件陣列,每個物件都描述一組主機。

blocks[i].netmask

字串。一組主機的子網路遮罩。例如:

blocks:
- netmask: "255.255.252.0"

blocks[i].gateway

字串。一組主機的預設閘道位址。例如:

blocks:
- netmask: "255.255.252.0"
  gateway: "172.16.23.254"

blocks[i].ips

物件陣列。每個物件都有個別的 IP 位址或 IP 位址的 CIDR 區塊。

  • 如果物件有獨立 IP 位址,也可以視需要設定主機名稱。

  • 如果將 ip 設為 CIDR 區塊,請勿指定 hostname 的值。

  • 如未指定 hostname 的值,VMware 適用的 Google Distributed Cloud 軟體會使用 vSphere 的 VM 名稱做為主機名稱。

blocks[i].isControlPlane

如果在管理員叢集設定檔中設定 infraConfigFilePath,且 IP 位址屬於控制層節點,請加入 isControlPlane: true。如果是使用者叢集 worker 節點,請指定 false 或省略該欄位,因為預設值為 false。

設定檔範例

本節提供一些設定,並填入範例值。

範例 1

這個範例指定了六個 IP 位址:兩個個別位址和一個包含四個位址的 CIDR 區塊。

blocks:
- netmask: "255.255.252.0"
  gateway: "203.0.113.1"
  ips:
  - ip: 198.51.100.10
    hostname: worker-node1
  - ip: 198.51.100.11
    hostname: worker-node2
  - ip: 198.51.100.12/30  # 198.51.100.12 - 198.51.100.15

範例 2

這個範例顯示為拓撲網域設定的 IP 封鎖檔案。

blocks:
- netmask: 255.255.255.0
  gateway: 100.115.222.254
  ips:
  - ip: 100.115.222.204
    hostname: worker-1
  - ip: 100.115.222.205
    hostname: cp-1
    isControlPlane: true
  - ip: 100.115.222.206
    hostname: cp-2
    isControlPlane: true
  - ip: 100.115.222.207
    hostname: cp-3
    isControlPlane: true
  - ip: 100.115.222.220/28 # 100.115.222.208 - 100.115.222.223
- netmask: 255.255.255.0
  gateway: 100.115.223.254
  ips:
  - ip: 100.115.223.206
    hostname: worker-2
  - ip: 100.115.223.220/28 # 100.115.223.208 - 100.115.223.223
- netmask: 255.255.255.0
  gateway: 100.115.224.254
  ips:
  - ip: 100.115.224.206
    hostname: worker-3
  - ip: 100.115.224.220/28 # 100.115.224.208 - 100.115.224.223

這個範例 IP 區塊檔案會預留三個子網路的 IP 位址,每個子網路都以 blocks[i] 表示。blocks[i].gateway 很重要,因為它是 IP 區塊的識別資訊。您可以在 vSphere 基礎架構設定檔中,將相同的 IP 位址新增至 VSphereInfraConfig 自訂資源中的 topologyDomains[i].network.gateway。

有三個 IP 設定了 isControlPlane: true,表示這些 IP 位址僅保留給控制層節點。在管理員叢集或使用者叢集的 IP 區塊檔案中,必須為控制層節點保留三個 IP 位址。請根據叢集的適用拓撲,在目標子網路中保留這些 IP。

由於控制層節點必須位於單一拓撲網域中,因此控制層節點的 IP 位址必須位於相同的 IP 區塊中。