File di blocco IP

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

Utilizzi un file di blocco IP per descrivere un insieme di macchine di nodi e la rete a cui sono connesse. Devi creare un file di blocco IP separato per ogni cluster. Sia i file di configurazione del cluster di amministrazione sia quelli del cluster utente contengono un campo chiamato 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 di utenti:

    • Se network.ipMode.type è impostato su "static" nel file di configurazione del cluster utente, elenca gli indirizzi IP dei 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 dei nodi del piano di controllo nel file di blocco IP del cluster utente. Gli indirizzi IP dei nodi del piano di controllo 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 dei nodi del piano di controllo nel file di blocco IP del cluster di amministrazione.

    • Cluster di amministrazione non HA 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 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, 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 singolo indirizzo IP o un blocco CIDR di indirizzi IP.

  • Se l'oggetto ha un indirizzo IP individuale, 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 è relativo a un nodo del piano di controllo, includi isControlPlane: true. Per i nodi worker del cluster di utenti, 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 inseriti.

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 contiene indirizzi IP riservati di tre subnet, ciascuna rappresentata come blocks[i]. Il valore 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 presenti tre IP configurati con isControlPlane: true, il che indica che questi indirizzi IP sono riservati solo ai nodi del control plane. Nel file di blocco IP del cluster di amministrazione o del cluster utente devono essere presenti tre indirizzi IP riservati per i nodi del piano di controllo. Prenotali nella sottorete 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.