Aggiunta di intervalli di indirizzi IPv4 dei pod

Questa pagina mostra come configurare intervalli di indirizzi IPv4 dei pod aggiuntivi per un cluster nativo di VPC e come specificare intervalli di indirizzi IPv4 dei pod personalizzati per i pool di nodi di un cluster nativo di VPC.

Gli intervalli di indirizzi IPv4 dei pod nei cluster VPC nativi provengono sempre dagli intervalli di indirizzi IPv4 secondari della subnet. Quando crei un nuovo cluster, gli assegni un intervallo di indirizzi IPv4 del pod predefinito.

• Per i cluster Autopilot e Standard, puoi configurare un cluster in modo che utilizzi intervalli di indirizzi IPv4 dei pod aggiuntivi. GKE utilizza questi intervalli di indirizzi IPv4 dei pod aggiuntivi per gli indirizzi IPv4 dei pod sui nodi creati nei pool di nodi futuri.
• Per i cluster Standard, puoi creare pool di nodi che utilizzano ciascuno un intervallo di indirizzi IPv4 secondari della subnet personalizzato per i propri indirizzi IPv4 dei pod.

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti operazioni:

• Attiva l'API Google Kubernetes Engine.
Attiva l'API Google Kubernetes Engine
• Se vuoi utilizzare Google Cloud CLI per questa attività, installala e poi inizializzala. Se hai già installato gcloud CLI, scarica l'ultima versione eseguendo gcloud components update.

• Assicurati di disporre del ruolo IAM (Identity and Access Management) Amministratore rete Compute per il progetto contenente la subnet del cluster. Questo è necessario per creare nuovi intervalli di indirizzi IPv4 secondari della subnet. Quando utilizzi un VPC condiviso, devi coordinarti con l'amministratore di rete per il progetto host del VPC condiviso.
• Assicurati che il cluster GKE sia un cluster VPC nativo. I cluster basati su route non supportano intervalli di indirizzi IPv4 dei pod aggiuntivi o intervalli di indirizzi IPv4 dei pod personalizzati del pool di nodi.
• Esamina la sezione Passaggi successivi.

Crea un nuovo intervallo di indirizzi IPv4 secondari della subnet

Per creare un nuovo intervallo di indirizzi IPv4 secondari della subnet, utilizza la consoleGoogle Cloud o Google Cloud CLI. Ogni subnet supporta fino a 30 intervalli di indirizzi IPv4 secondari. Per saperne di più, consulta Modificare gli intervalli IPv4 secondari nella documentazione di VPC.

gcloud compute networks subnets update SUBNET_NAME \
    --region=REGION \
    --add-secondary-ranges=SECONDARY_RANGE_NAME=SECONDARY_RANGE_CIDR

Assegna intervalli IPv4 di pod aggiuntivi a un cluster

Puoi assegnare intervalli di indirizzi IPv4 dei pod aggiuntivi a livello di cluster, applicabili ai nuovi nodi creati nei nuovi node pool che crei nel cluster. Per assegnare intervalli di indirizzi IPv4 dei pod aggiuntivi a un cluster, devi prima creare un nuovo intervallo di indirizzi IPv4 secondari della subnet.

L'assegnazione di intervalli di indirizzi IPv4 dei pod aggiuntivi a un cluster è supportata da:

• Cluster Autopilot che eseguono GKE versione 1.26 e successive

• Cluster standard

Cercare gli intervalli IPv4 dei pod del cluster

Per cercare l'intervallo di indirizzi IPv4 dei pod predefinito di un cluster e qualsiasi altro intervallo di indirizzi IPv4 dei pod assegnato al cluster, utilizza il seguente comando:

gcloud container clusters describe CLUSTER_NAME \
    --location=COMPUTE_LOCATION

Sostituisci quanto segue:

• CLUSTER_NAME: il nome del cluster.
• COMPUTE_LOCATION: la posizione di Compute Engine per il cluster.

L'output è simile al seguente, che include IPAllocationPolicy del cluster:

ipAllocationPolicy:
  clusterSecondaryRangeName: cluster-pods
  clusterIpv4CidrBlock: 10.10.0.0/23
  additionalPodRangesConfig:
    podRangeNames:
      - pod-range-1
      - pod-range-2

dove:

• clusterSecondaryRangeName: il nome dell'intervallo di indirizzi IPv4 secondari della subnet utilizzato come intervallo di indirizzi IPv4 dei pod predefinito del cluster, definito al momento della creazione del cluster.
• clusterIpv4CidrBlock: il CIDR dell'intervallo di indirizzi IPv4 secondario della subnet per gli indirizzi IPv4 dei pod, definito al momento della creazione del cluster.
• additionalPodRangesConfig.podRangeNames: un elenco di eventuali intervalli di indirizzi IPv4 secondari della subnet assegnati aggiuntivi per gli indirizzi IPv4 dei pod.

Intervalli di indirizzi IPv4 dei pod personalizzati del node pool

Per i cluster Standard che eseguono GKE 1.20.4-gke.500 o versioni successive, puoi assegnare un intervallo IPv4 Pod personalizzato a un nuovo pool di nodi utilizzando uno dei seguenti metodi:

• Intervallo di indirizzi IPv4 dei pod personalizzato del node pool gestito da GKE: con questa opzione, crei un nuovo pool di nodi e fornisci a GKE le informazioni necessarie per creare un nuovo intervallo di indirizzi IPv4 secondario della subnet nella subnet del cluster. A ogni nuovo nodo creato nel nuovo pool di nodi viene assegnato un intervallo di indirizzi IP alias per i suoi indirizzi IPv4 dei pod e ogni intervallo di indirizzi IP alias proviene dal nuovo intervallo di indirizzi IPv4 secondari della subnet creato da GKE. Questa opzione può essere utilizzata solo se sia il cluster che la rete VPC contenente la subnet del cluster si trovano nello stesso progetto.

• Intervallo di indirizzi IPv4 dei pod personalizzato del pool di nodi gestito dall'utente: con questa opzione, crei un nuovo pool di nodi in cui GKE utilizza un intervallo di indirizzi IPv4 secondario della subnet esistente. A ogni nuovo nodo creato nel nuovo pool di nodi viene assegnato un intervallo di indirizzi IP alias per i relativi indirizzi IPv4 dei pod e ogni intervallo di indirizzi IP alias proviene dall'intervallo di indirizzi IPv4 secondari della subnet che indichi a GKE di utilizzare. Se il cluster si trova in un progetto di servizio VPC condiviso e la subnet del cluster si trova nella rete VPC condivisa del progetto host, devi utilizzare questa opzione.

L'intervallo di indirizzi IPv4 dei pod personalizzato di un pool di nodi sostituisce tutti gli intervalli di indirizzi IPv4 dei pod definiti a livello di cluster, inclusi gli intervalli di indirizzi IPv4 dei pod aggiuntivi assegnati al cluster. Gli intervalli di indirizzi IPv4 dei pod personalizzati assegnati ai pool di nodi sono anche chiamati CIDR multi-pod discontiguo.

Esempio di intervallo di indirizzi IPv4 del pod personalizzato del node pool

Il seguente diagramma mostra un cluster nativo di VPC con intervalli di indirizzi IPv4 dei pod gestiti dall'utente:

Nel diagramma precedente:

• Il numero massimo di pod per nodo per ogni pool di nodi nel cluster è stato impostato su 64. Per ospitare un massimo di 64 pod per nodo, GKE crea ogni nodo con un intervallo di indirizzi IP alias /25, fornendo 128 indirizzi IPv4 dei pod per nodo.
• L'intervallo di indirizzi IPv4 dei pod predefinito del cluster è /24. Poiché ogni nodo richiede un /25 per gli indirizzi IPv4 dei pod, l'intervallo di indirizzi IPv4 dei pod predefinito del cluster supporta solo due nodi.
• Per supportare nodi aggiuntivi, un amministratore del cluster ha creato un pool di nodi aggiuntivo, mantenendo il numero massimo di pod per nodo pari a 64. Il pool di nodi aggiuntivo utilizza un intervallo di indirizzi IPv4 dei pod /20 personalizzato, che supporta 32 nodi aggiuntivi.

Intervallo di indirizzi IPv4 dei pod personalizzato del node pool gestito da GKE

Per creare un pool di nodi con un intervallo di indirizzi IPv4 Pod personalizzato gestito da GKE, utilizza l'interfaccia a riga di comando gcloud o l'API GKE come segue:

gcloud container node-pools create POOL_NAME \
  --cluster=CLUSTER_NAME \
  --location=COMPUTE_LOCATION \
  --create-pod-ipv4-range=name=SECONDARY_RANGE_NAME,range=CIDR_OR_NETMASK

"nodePool": {
  "name": "POOL_NAME",
  ...
  "networkConfig": {
    "createPodRange": true,
    "podRange": "SECONDARY_RANGE_NAME",
    "podIpv4CidrBlock": "CIDR_OR_NETMASK"
    }
}

Intervallo di indirizzi IPv4 del pod personalizzato del pool di nodi gestito dall'utente

Per creare un pool di nodi con un intervallo di indirizzi IPv4 dei pod personalizzato e gestito dall'utente, utilizza gcloud CLI o l'API GKE nel seguente modo:

gcloud container node-pools create POOL_NAME \
    --cluster=CLUSTER_NAME \
    --location=COMPUTE_LOCATION \
    --pod-ipv4-range SECONDARY_RANGE_NAME

"nodePool": {
  "name": "POOL_NAME",
  ...
  "networkConfig": {
    "createPodRange": false,
    "podRange": "SECONDARY_RANGE_NAME"
    }
}

Cercare gli intervalli IPv4 dei pod pool di nodi

Per cercare l'intervallo di indirizzi IPv4 dei pod di un pool di nodi, utilizza il seguente comando:

gcloud container node-pools describe POOL_NAME \
    --cluster=CLUSTER_NAME \
    --location=COMPUTE_LOCATION

Sostituisci quanto segue:

• POOL_NAME: il nome del pool di nodi.
• CLUSTER_NAME: il nome del cluster.
• COMPUTE_LOCATION: la posizione di Compute Engine per il cluster.

L'output è simile al seguente, che include NodeNetworkConfig del pool di nodi:

  networkConfig:
    podRange: podrange
    podIpv4CidrBlock: 192.168.0.0/18

dove:

• podRange: il nome dell'intervallo di indirizzi IPv4 secondari della subnet per gli indirizzi IPv4 dei pod del pool di nodi.
• podIpv4CidrBlock: il CIDR dell'intervallo di indirizzi IPv4 secondario della subnet per gli indirizzi IPv4 dei pod del pool di nodi.

Se il pool di nodi utilizza un intervallo di indirizzi IPv4 dei pod personalizzato, i valori podRange e podIpv4CidrBlock sono diversi dall'intervallo di indirizzi IPv4 dei pod predefinito del cluster.

Passaggi successivi

Dopo aver assegnato intervalli di indirizzi IPv4 dei pod aggiuntivi a un cluster o aver configurato intervalli di indirizzi IPv4 dei pod personalizzati del pool di nodi, GKE aggiorna la regola firewall VPC gke-[cluster-name]-[cluster-hash]-allcreata automaticamente in modo che il suo intervallo di origine includa tutti gli indirizzi IPv4 dei pod.

Potresti anche dover:

• Aggiorna la configurazione dell'agente IP Masquerade del cluster. L'insieme effettivo di CIDR non masquerade deve includere tutti gli intervalli di indirizzi IPv4 dei pod utilizzati dal cluster (e dai relativi node pool). Per maggiori informazioni, vedi Controllare lo stato di ip-masq-agent e Configurare e implementare ip-masq-agent.

• Rivedi la configurazione NetworkPolicy del cluster. Potrebbe essere necessario aggiornare gli attributi ipBlock che fanno riferimento agli intervalli di indirizzi IPv4 del pod.

• Risolvi i problemi di connettività utilizzando i log di flusso VPC e la registrazione dei log delle regole firewall.

Passaggi successivi

• Scopri di più sui cluster nativi di VPC.
• Leggi la panoramica della rete GKE.
• Scopri di più sull'ottimizzazione dell'allocazione degli indirizzi IP.
• Scopri di più sugli approfondimenti sull'utilizzo degli indirizzi IP di GKE.