File di blocco IP

Un file di blocco IP elenca gli indirizzi IP e, facoltativamente, i nomi host delle macchine nodo in un cluster Google Distributed Cloud solo software per VMware, insieme alla netmask e al gateway della rete. Utilizzi un file di blocco IP quando i nodi del cluster hanno indirizzi IP statici, ad esempio i nodi worker in modalità IP statico o i nodi del control plane nei cluster che utilizzano domini di topologia. Devi creare un file di blocco IP separato per ogni cluster e specificare il percorso assoluto o relativo nel campo network.ipMode.ipBlockFilePath del file di configurazione del cluster di amministrazione o utente.

Informazioni sui file di blocco IP

Utilizza un file di blocco IP per elencare gli indirizzi IP e, facoltativamente, i nomi host nei seguenti casi:

  • Cluster utente:

    • Se network.ipMode.type è impostato su "static" nel file di configurazione del cluster utente, elenca gli indirizzi IP dei nodi worker nel file del blocco IP del cluster utente.

    • Se infraConfigFilePath è configurato nel file di configurazione del cluster di amministrazione (che abilita i domini di topologia), elenca gli indirizzi IP dei nodi del control plane nel file del blocco IP del cluster utente. Gli indirizzi IP dei nodi del control plane sono sempre indirizzi IP statici, anche se i nodi worker utilizzano DHCP.

  • Cluster di amministrazione:

    • Se infraConfigFilePath è configurato nel file di configurazione del cluster di amministrazione (che abilita i domini di topologia), elenca gli indirizzi IP dei nodi del control plane nel file del blocco IP del cluster di amministrazione.

    • Cluster di amministrazione non ad alta affidabilità 1.16 e versioni precedenti: elenca gli indirizzi IP per il nodo del control plane e i nodi aggiuntivi nel file del blocco IP del cluster di amministrazione.

    • Cluster di amministrazione HA 1.16 e versioni precedenti: elenca gli indirizzi IP dei nodi aggiuntivi in un file di blocco IP.

    • Cluster utente kubeception 1.29 e versioni precedenti: elenca gli indirizzi IP dei nodi del control plane del cluster utente nel file del blocco IP del cluster di amministrazione.

Modello

Compilazione dei campi in un file di blocco IP

Le sezioni seguenti descrivono i campi di un file di blocco IP.

blocks

Un array di oggetti, ciascuno dei quali descrive un insieme di host.

blocks[i].netmask

Stringa. La subnet mask per l'insieme di host. Ad esempio:

blocks:
- netmask: "255.255.252.0"

blocks[i].gateway

Stringa. L'indirizzo del gateway predefinito per l'insieme di host. Ad esempio:

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

blocks[i].ips

Un array di oggetti. Ogni oggetto ha un indirizzo IP individuale o un blocco di indirizzi IP CIDR.

  • Se l'oggetto ha un indirizzo IP individuale, facoltativamente può avere anche un nome host.

  • Se imposti ip su un blocco CIDR, non specificare un valore per hostname.

  • Se non specifichi un valore per hostname, Google Distributed Cloud (solo software) per VMware utilizza il nome della VM di vSphere come nome host.

blocks[i].isControlPlane

Se infraConfigFilePath è configurato nel file di configurazione del cluster di amministrazione e se l'indirizzo IP è per un nodo del control plane, includi isControlPlane: true. Per i nodi worker dei cluster utente, specifica false o ometti il campo perché il valore predefinito è false.

File di configurazione di esempio

Questa sezione fornisce alcune configurazioni con valori di esempio compilati.

Esempio 1

Questo esempio specifica sei indirizzi IP: due indirizzi singoli e un blocco CIDR di quattro indirizzi.

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

Esempio 2

Questo esempio mostra un file di blocco IP configurato per i domini di topologia.

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

Questo file di blocco IP di esempio prenota gli indirizzi IP di tre subnet e ogni subnet è rappresentata come blocks[i]. Il blocks[i].gateway è importante, in quanto funge da identificazione del blocco IP. Aggiungi lo stesso indirizzo IP a topologyDomains[i].network.gateway nella risorsa personalizzata VSphereInfraConfig all'interno del file di configurazione dell'infrastruttura vSphere.

Sono configurati tre IP con isControlPlane: true, il che indica che questi indirizzi IP sono riservati solo ai nodi del control plane. Nel file del blocco IP del cluster di amministrazione o del cluster utente, devono essere presenti tre indirizzi IP riservati per i nodi del control plane. Prenotale nella subnet di destinazione in base alla topologia applicabile del cluster.

Poiché i nodi del control plane devono trovarsi in un unico dominio di topologia, gli indirizzi IP dei nodi del control plane devono trovarsi nello stesso blocco IP.