File di blocco IP

Questa pagina descrive i campi di un file di blocco IP, che viene utilizzato nella configurazione di Google Distributed Cloud.

Utilizzi un file di blocchi IP per descrivere un insieme di macchine nodo e la rete a cui sono connesse. Crea un file di blocchi IP separato per ogni cluster. Entrambi i file di configurazione del cluster di amministrazione e del cluster utente hanno un campo denominato network.ipMode.ipBlockFilePath. In questo campo specifichi il percorso assoluto o relativo del 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 per i nodi worker nel file di blocco IP del cluster utente.

    • Se infraConfigFilePath è configurato nel file di configurazione del cluster di amministrazione (che attiva i domini di topologia), elenca gli indirizzi IP per i nodi del control plane nel file del blocco IP del cluster utente. Gli indirizzi IP per i 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 attiva i domini di topologia), elenca gli indirizzi IP per i nodi del control plane nel file di blocco IP del cluster di amministrazione.

    • Cluster di amministrazione non HA 1.16 e versioni precedenti: elenca gli indirizzi IP per i nodi del control plane e i nodi aggiuntivi nel file di blocco IP del cluster di amministrazione.

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

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

Modello

Compilare i campi di un file di blocco IP

Questa sezione descrive i campi di un file di blocco IP.

blocks

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

blocks[i].netmask

Stringa. La subnet mask per il set di host. Ad esempio:

blocks:
- netmask: "255.255.252.0"

blocks[i].gateway

Stringa. L'indirizzo del gateway predefinito per il set 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 CIDR di indirizzi IP.

  • 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 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 del cluster utente, specifica false o ometti il campo perché il valore predefinito è false.

File di configurazione di esempio

La sezione fornisce alcune configurazioni con valori di esempio compilati.

Esempio 1

Questo esempio specifica sei indirizzi IP: due indirizzi individuali 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 ha riservato indirizzi IP da tre subnet e ogni subnet è rappresentata come blocks[i]. blocks[i].gateway è importante perché 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 riservati tre indirizzi IP per i nodi del control plane. Riservali 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.