Parametri del servizio LoadBalancer

Questa pagina descrive i parametri per i manifest dei servizi che controllano il comportamento e la configurazione del servizio LoadBalancer. Prima di leggere questa pagina, assicurati di conoscere i concetti del servizio LoadBalancer di Google Kubernetes Engine (GKE).

Parametri di servizio

GKE supporta i seguenti parametri per i servizi LoadBalancer.

Parametro Campo Servizio e descrizione Interno Esterno Supporto delle versioni
Bilanciatore del carico di rete passthrough interno
  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal
  • networking.gke.io/load-balancer-type: "Internal"

Indica a GKE di creare un bilanciatore del carico di rete passthrough interno.

Il bilanciatore del carico utilizza i backend NEG GCE_VM_IP se si verifica una delle seguenti condizioni:

  • Il manifest del servizio viene applicato a un cluster in cui è abilitato il sottoinsieme GKE.
  • Il manifest del servizio viene applicato a un cluster che esegue GKE versione 1.36 o successive. La suddivisione in sottoinsiemi di GKE viene attivata automaticamente in GKE versione 1.36 e successive.

In tutte le altre situazioni, il bilanciatore del carico utilizza i backend dei gruppi di istanze. Per saperne di più, vedi Raggruppamento dei nodi.
  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal: richiede GKE versione 1.33.1-gke.1779000 e successive e l'impostazione secondaria GKE abilitata.
  • networking.gke.io/load-balancer-type: "Internal": tutte le versioni supportate.

Ti consigliamo spec.loadBalancerClass se il tuo cluster utilizza GKE versione 1.33.1-gke.1779000 o successiva e ha il subsetting GKE abilitato. Questo attributo è immutabile e non può essere modificato dopo che il manifest del servizio è stato applicato a un cluster.
Bilanciatore del carico di rete passthrough esterno regionale basato sui servizi di backend
  • Comportamento predefinito in GKE 1.37 e versioni successive
  • spec.loadBalancerClass: networking.gke.io/l4-regional-external
  • cloud.google.com/l4-rbs: "enabled"

Indica a GKE di creare un bilanciatore del carico di rete passthrough esterno regionale.

Il bilanciatore del carico utilizza i backend NEG GCE_VM_IP se si verifica una delle seguenti condizioni:

  • Il servizio viene creato in un cluster che esegue GKE versione 1.37 o successive. Non sono richieste annotazioni o classi.
  • Il manifest del servizio include spec.loadBalancerClass: networking.gke.io/l4-regional-external e viene applicato a un cluster che esegue GKE versione 1.33.1-gke.1779000 a 1.36.
  • Il manifest del servizio include l'annotazione cloud.google.com/l4-rbs: "enabled" e viene applicato a un cluster che esegue GKE versione da 1.32.2-gke.1652000 a 1.36.

In tutte le altre situazioni, il bilanciatore del carico utilizza i backend dei gruppi di istanze. Per saperne di più, vedi Raggruppamento dei nodi.
  • spec.loadBalancerClass: networking.gke.io/l4-regional-external: richiede GKE 1.33.1-gke.1779000 e versioni successive.
  • cloud.google.com/l4-rbs: "enabled": tutte le versioni supportate.

Ti consigliamo spec.loadBalancerClass se il tuo cluster utilizza GKE versione 1.33.1-gke.1779000 fino alla 1.36. Questo attributo è immutabile e non può essere modificato dopo l'applicazione del manifest del servizio a un cluster. In GKE 1.37 e versioni successive, non sono necessari campi per questo tipo di bilanciatore del carico.
Bilanciamento del carico ponderato networking.gke.io/weighted-load-balancing: "pods-per-node"

Consente ai nodi con più pod di gestione di ricevere una percentuale maggiore di nuove connessioni rispetto ai nodi con meno pod di gestione.

 GKE 1.31.0+
Policy di traffico interno spec.internalTrafficPolicy

Se impostato sul valore Local, GKE instrada solo i pacchetti dai pod client su un nodo ai pod di pubblicazione sullo stesso nodo. Se impostato sul valore Cluster, GKE instrada i pacchetti dai pod client su un nodo ai pod di distribuzione su qualsiasi nodo. Per maggiori dettagli, consulta Policy del traffico interno dei servizi.

Questo parametro non è supportato nei cluster che eseguono GKE Dataplane V2.

 GKE 1.22+
Policy del traffico esterno spec.externalTrafficPolicy

Controlla quali VM nodo superano i controlli di integrità del bilanciatore del carico e come i pacchetti vengono instradati ai pod pronti e in servizio nel cluster. Controlla anche il modo in cui i nodi vengono raggruppati in NEG GCE_VM_IP quando è abilitato il sottoinsieme GKE.

Per i dettagli, consulta Concetti relativi ai servizi LoadBalancer.

 GKE 1.14+ (1.23.4-gke.400+ per il pool di nodi Windows).
Affinità a livello di zona spec.trafficDistribution: PreferSameZone

Abilita l'affinità di zona per i servizi LoadBalancer interni. L'affinità zonale controlla la zona a cui il bilanciatore del carico di rete passthrough interno indirizza il traffico in entrata per i client compatibili quando è possibile una corrispondenza zonale. Per utilizzare l'affinità di zona, devi abilitare il sottoinsieme GKE (abilitato per impostazione predefinita a partire dalla versione 1.36 di GKE).

Per maggiori informazioni, consulta Affinità di zona e distribuzione del traffico.

 Anteprima in GKE 1.33.3-gke.1392000 e versioni successive. Disponibile a livello generale in GKE versione 1.36 e successive.
Porta del controllo di integrità spec.healthCheckNodePort

Esegue il deployment di un controllo di integrità del bilanciatore del carico per i servizi LoadBalancer. Questo parametro è valido solo se spec.externalTrafficPolicy è impostato su Local.

 Tutte le versioni supportate.
Regole firewall e lista consentita di indirizzi IP di origine spec.loadBalancerSourceRanges

Configura regole firewall facoltative in GKE e nella rete VPC per consentire solo determinati intervalli di origine. kube-proxy configura anche le regole iptables in modo che corrispondano agli intervalli di origine specificati.

 Tutte le versioni supportate.
Indirizzi IP statici
  • spec.loadBalancerIP (solo IPv4)
  • networking.gke.io/load-balancer-ip-addresses

Specifica un indirizzo IPv4 statico, un intervallo di indirizzi IPv6 statici o entrambi, assegnati alle regole di forwarding del bilanciatore del carico. Consulta Considerazioni per la condivisione di un indirizzo IP comune per i requisiti di configurazione e i dettagli di implementazione importanti.
  • spec.loadBalancerIP: tutte le versioni supportate.
  • networking.gke.io/load-balancer-ip-addresses: GKE 1.29 e versioni successive. Consulta Parametri dell'indirizzo IP statico per ulteriori requisiti di configurazione o annotazione del cluster.
Network Service Tiers cloud.google.com/network-tier

Specifica quali Network Service Tiers GKE utilizza per la regola di forwarding esterna e l'indirizzo IP. I valori validi per l'annotazione sono Standard e Premium (predefinito).

 GKE 1.19 e versioni successive.
Subnet personalizzata
  • networking.gke.io/internal-load-balancer-subnet
  • networking.gke.io/load-balancer-subnet
(si applica solo a IPv6)
  • networking.gke.io/internal-load-balancer-subnet: tutte le versioni supportate
  • networking.gke.io/load-balancer-subnet: GKE 1.29 e versioni successive. Per ulteriori requisiti, consulta Annotazioni delle subnet personalizzate.
Accesso globale networking.gke.io/internal-load-balancer-allow-global-access: "true"

Consente ai client in qualsiasi regione della rete VPC o di una rete connessa di accedere all'indirizzo IP della regola di forwarding.

 Anteprima in GKE 1.16+. Disponibilità generale in GKE 1.17.9-gke.600+.
Tutte le porte

GKE configura automaticamente la regola di forwarding per utilizzare tutte le porte se in spec.ports[].port sono specificate più di cinque porte univoche (fino a 100).

 GKE versione 1.18.19-gke.1400 o successive
ipFamilyPolicy

spec.ipFamilyPolicy

Definisce il modo in cui GKE alloca gli indirizzi IP a un servizio. Puoi definire spec.ipFamilyPolicy come SingleStack, PreferDualStack o RequireDualStack.

Per saperne di più, consulta Servizi a doppio stack IPv4/IPv6.

 I cluster GKE nella versione 1.29 o successive supportano la rete dual-stack per i servizi LoadBalancer.
ipFamilies (facoltativo)

spec.ipFamilies

Definisce la famiglia di indirizzi IP per l'allocazione di servizi a stack singolo o doppio. Utilizza uno qualsiasi dei seguenti valori:

  • IPv4 solo per il servizio IPv4 con stack singolo.
  • IPv6 solo per il servizio IPv6.
  • IPv4,IPv6 per il servizio a doppio stack in cui l'indirizzo IP principale del servizio è IPv4.
  • IPv6,IPv4 per il servizio a doppio stack in cui l'indirizzo IP principale del servizio è IPv6.
 I cluster GKE nella versione 1.29 o successive supportano la rete dual-stack per i servizi LoadBalancer.

Porta del controllo di integrità

Come descritto in Controlli di integrità del bilanciatore del carico, GKE esegue sempre il deployment di un controllo di integrità del bilanciatore del carico quando crea un bilanciatore del carico di rete passthrough esterno regionale o un bilanciatore del carico di rete passthrough interno.

La possibilità di configurare o meno il parametro healthCheckNodePort dipende dalla seguente configurazione di externalTrafficPolicy:

externalTrafficPolicy Porta del controllo di integrità
Cluster

Non puoi utilizzare spec.healthCheckNodePort.

Local

Puoi selezionare una porta personalizzata utilizzando spec.healthCheckNodePort. Se non specificato, il control plane Kubernetes assegna una porta di controllo di integrità dall'intervallo di porte del nodo.

Regole firewall e lista consentita di indirizzi IP di origine

A meno che tu non abbia configurato un cluster per saltare la creazione di regole firewall VPC per i servizi LoadBalancer, GKE crea una regola firewall VPC in entrata per ogni servizio.

Ogni regola firewall creata automaticamente ha le seguenti caratteristiche:

  • La direzione della regola firewall è in entrata e la sua azione è Consenti. Le regole firewall di negazione implicita in entrata in Google Cloud indicano che GKE utilizza un modello di lista consentita quando crea regole firewall in entrata.
  • GKE imposta il protocollo e la porta di destinazione della regola firewall su quelli specificati nell'elenco spec.ports[] del servizio.
  • GKE configura le regole firewall per i servizi LoadBalancer impostando esplicitamente il parametro di destinazione sull'indirizzo IP virtuale del LoadBalancer (la regola di forwarding del bilanciatore del carico).
  • GKE imposta il parametro target della regola firewall in modo da includere tutti i nodi del cluster.
  • Se il servizio include spec.loadBalancerSourceRanges[], GKE imposta il parametro source della regola firewall sugli indirizzi IP in questo elenco. Inoltre, GKE configura route e regole all'interno del sistema operativo del nodo per limitare gli indirizzi IP di origine per il traffico bilanciato del carico, utilizzando kube-proxy e iptables (sui cluster che non utilizzano GKE Dataplane V2) o cilium-agent e regole eBPF (sui cluster con GKE Dataplane V2). Se il servizio non include loadBalancerSourceRanges[], GKE imposta il parametro di origine della regola firewall su tutti gli indirizzi IP (0.0.0.0/0).

Indirizzi IP statici

Puoi creare un indirizzo IP statico e configurare GKE in modo che assegni questo indirizzo statico alla regola di forwarding del bilanciatore del carico. L'utilizzo di un indirizzo IP statico garantisce che l'indirizzo IP del bilanciatore del carico rimanga invariato anche se apporti modifiche al servizio LoadBalancer. Senza un indirizzo IP statico, GKE potrebbe assegnare un indirizzo IP diverso alla regola di forwarding del bilanciatore del carico quando aggiorni un servizio LoadBalancer. L'indirizzo IP della regola di forwarding non è lo stesso dell'indirizzo spec.clusterIP del servizio. L'indirizzo ClusterIP di un servizio non cambia mai quando aggiorni un servizio LoadBalancer.

Parametri dell'indirizzo IP statico

Per indicare a un servizio LoadBalancer di utilizzare un indirizzo IP statico, utilizza il parametro spec.loadBalancerIP o l'annotazione networking.gke.io/load-balancer-ip-addresses. In GKE versione 1.29 e successive, l'annotazione ha la precedenza su spec.loadBalancerIP se il manifest del servizio contiene sia il parametro sia l'annotazione.

Parametro o annotazione e valore Requisiti e funzionalità
spec.loadBalancerIP:
IPv4_ADDRESS

Puoi specificare un indirizzo IPv4 interno statico per un servizio di bilanciatore del carico interno solo IPv4. Puoi specificare un indirizzo IPv4 esterno statico per un servizio LoadBalancer esterno solo IPv4. Il parametro funziona con tutte le versioni di GKE supportate.
networking.gke.io/load-balancer-ip-addresses:
IP_ADDRESS_RESOURCE_NAME
  • Per i servizi LoadBalancer a stack singolo, imposta il valore dell'annotazione sul nome della risorsa indirizzo IPv4 o IPv6, non sull'indirizzo IP stesso.
  • Per i servizi LoadBalancer a doppio stack, imposta il valore dell'annotazione sul nome della risorsa dell'indirizzo IPv4 statico e sul nome della risorsa dell'intervallo di indirizzi IPv6 statico separati da una virgola.

Puoi specificare un indirizzo IPv4 statico, un intervallo di indirizzi IPv6 statici o entrambi per i servizi di bilanciamento del carico interno ed esterno solo IPv4, solo IPv6 e dual-stack. L'annotazione richiede GKE 1.29 o versioni successive e i seguenti requisiti aggiuntivi:

  • Per utilizzare questa annotazione con un servizio LoadBalancer interno, il cluster deve avere il subsetting GKE abilitato. Il sottoinsieme GKE è abilitato per impostazione predefinita in GKE 1.36 e versioni successive.
  • Per utilizzare questa annotazione con un servizio LoadBalancer esterno, devi impostare il campo spec.loadBalancerClass sul valore networking.gke.io/l4-regional-external nel manifest del servizio quando crei il servizio LoadBalancer esterno.

Considerazioni per la condivisione di un indirizzo IP comune

Due o più servizi LoadBalancer possono fare riferimento allo stesso indirizzo IP statico se la regola di forwarding per ogni bilanciatore del carico utilizza una combinazione univoca di indirizzo IP, protocollo, specifica della porta e specifica dei Network Service Tiers, come indicato nella tabella in questa sezione. Inoltre:

  • Gli indirizzi IPv6 statici sono in realtà intervalli di indirizzi IPv6 /96, ma GKE configura i nodi in modo che accettino pacchetti solo sul primo indirizzo IPv6 (/128) nell'intervallo /96.

  • Affinché due o più servizi Internal Load Balancer utilizzino lo stesso indirizzo IPv4 interno o lo stesso intervallo di indirizzi IPv6 interni, l'indirizzo IP statico deve essere creato con lo scopo SHARED_LOADBALANCER_VIP.

Servizio LoadBalancer interno Servizio LoadBalancer esterno
Specifica della porta

Le regole di forwarding per i bilanciatori del carico di rete passthrough interni supportano fino a cinque numeri di porta individuali oppure possono essere configurate per utilizzare tutte le porte.

Quando un servizio Internal LoadBalancer ha più di cinque spec.ports[] specificati, GKE configura la regola di forwarding per il bilanciatore del carico di rete passthrough interno in modo che utilizzi tutte le porte.

Le regole di forwarding con lo stesso indirizzo IP e lo stesso protocollo non possono avere porte sovrapposte. Ciò significa che non puoi creare più servizi Internal LoadBalancer che condividono lo stesso indirizzo IP, protocollo e porta o porte. Ad esempio:

  • Se crei un servizio Internal LoadBalancer utilizzando la porta TCP 80, non puoi creare un altro servizio utilizzando le porte TCP 80, 81 e 90 perché la porta 80 si sovrappone.
  • Se un servizio Internal LoadBalancer utilizza le porte TCP 80, 8080 e 90, non puoi creare un altro servizio che utilizzi TCP su tutte le porte, in quanto ciò comporterebbe anche la sovrapposizione delle porte

Per saperne di più, consulta le regole di forwarding del bilanciatore del carico di rete passthrough interno che utilizzano un indirizzo IP comune.

Per i cluster che eseguono versioni di GKE precedenti alla 1.37, GKE crea un bilanciatore del carico di rete passthrough esterno regionale basato su pool di destinazione se il manifest del servizio LoadBalancer non ha il campo spec.loadBalancerClass impostato sul valore networking.gke.io/l4-regional-external o non include l'annotazione cloud.google.com/l4-rbs: "enabled". Per i cluster che eseguono GKE 1.37 o versioni successive, devi impostare esplicitamente spec.loadBalancerClass: "networking.gke.io/l4-regional-external-legacy" per creare un bilanciatore del carico di rete passthrough esterno regionale basato su un pool di destinazione.

Le regole di forwarding per i bilanciatori del carico di rete passthrough esterni regionali basati su pool di destinazione devono utilizzare intervalli di porte contigui. L'intervallo di porte contigue include tutte le porte necessarie al servizio, ma potrebbe includere anche porte aggiuntive non utilizzate dal servizio. Ad esempio, un servizio LoadBalancer esterno basato su un bilanciatore del carico di rete passthrough esterno regionale basato su un pool di destinazione che specifica le porte 80 e 443 nel manifest del servizio utilizza una regola di forwarding del bilanciatore del carico con un intervallo di porte compreso tra 80 e 443. Questo intervallo di porte impedisce ad altri servizi External LoadBalancer di utilizzare le porte 80, 443 e qualsiasi numero compreso tra 80 e 443.

GKE crea un bilanciatore del carico di rete passthrough esterno regionale basato su un servizio di backend per impostazione predefinita nelle versioni 1.37 o successive. Nelle versioni precedenti, GKE crea il bilanciatore del carico se il manifest del servizio LoadBalancer include il campo spec.loadBalancerClass impostato sul valore networking.gke.io/l4-regional-external. Le regole di forwarding per i bilanciatori del carico di rete passthrough esterni regionali basati su servizio di backend supportano fino a cinque numeri di porta discreti o un intervallo di porte contiguo.
Network Service Tiers Non configurabile: gli indirizzi interni sono sempre di livello Premium.

Configurabile per gli indirizzi IPv4 esterni statici a livello di regione. Gli intervalli di indirizzi IPv6 esterni regionali statici possono essere creati solo nel livello Premium.

La specifica di Network Service Tiers dell'indirizzo IP esterno statico deve corrispondere a:

  • Il livello specificato nell'annotazione cloud.google.com/network-tier del manifest del servizio LoadBalancer, se l'annotazione è presente nel manifest oppure
  • Il livello predefinito del progetto, se l'annotazione cloud.google.com/network-tier non è presente nel manifest del servizio LoadBalancer.

Il livello predefinito del progetto è Premium, a meno che tu non l'abbia configurato in modo diverso.

Prenotazione dell'indirizzo IP

GKE non riserva gli indirizzi IP statici configurati utilizzando l'annotazione spec.loadBalancerIP o networking.gke.io/load-balancer-ip-addresses. Ciò significa che l'indirizzo IP assegnato al servizio può essere rilasciato quando il servizio viene eliminato.

Per mantenere riservato l'indirizzo IP, devi creare manualmente una risorsa indirizzo nel tuo progetto. L'indirizzo IP statico deve avere i seguenti attributi:

  • Essere solo regionali.
  • Trovarsi nella stessa regione del cluster.
  • Trovarsi nello stesso Network Service Tiers del servizio LoadBalancer.
  • Avere un nome che non utilizzi il nome del bilanciatore del carico, prefissi come k8s- o l'UUID del servizio.

Se non riservi l'indirizzo, i log del progetto possono contenere voci relative alle risorse di indirizzi create e rimosse poco dopo. Si tratta di una parte normale del provisioning del servizio e deve essere prevista.

Subnet bilanciatore del carico

Puoi configurare un servizio Internal LoadBalancer per utilizzare un indirizzo IPv4, un intervallo di indirizzi IPv6 o entrambi temporanei o statici in una subnet personalizzata che si trova nella stessa regione e rete VPC del cluster. Utilizza una subnet personalizzata per un servizio LoadBalancer interno per:

  • Raggruppa i bilanciatori del carico di rete passthrough interni creati dai servizi LoadBalancer interni di due o più cluster GKE nella stessa rete VPC e nella stessa regione.
  • Crea servizi LoadBalancer interni i cui bilanciatori del carico di rete passthrough interni hanno indirizzi IPv4 separati dagli indirizzi IPv4 dei nodi del cluster.
  • In un cluster dual-stack, crea servizi Internal LoadBalancer i cui bilanciatori del carico di rete passthrough interni hanno intervalli di indirizzi IPv6 separati dagli indirizzi IPv6 dei nodi e dei pod del cluster. Una subnet LoadBalancer personalizzata è obbligatoria per supportare i servizi Internal LoadBalancer se la subnet del cluster ha un intervallo di indirizzi IPv6 esterno.

Puoi configurare un servizio External LoadBalancer per utilizzare un intervallo di indirizzi IPv6 effimero o statico in una subnet personalizzata che si trova nella stessa regione e nella stessa rete VPC del cluster. Utilizza una subnet personalizzata per creare servizi LoadBalancer esterni i cui bilanciatori del carico di rete passthrough esterni regionali hanno intervalli di indirizzi IPv6 separati dagli indirizzi IPv6 dei nodi e dei pod del cluster. Una subnet LoadBalancer personalizzata è obbligatoria per supportare i servizi LoadBalancer esterni in un cluster dual-stack perché la subnet del cluster ha un intervallo di indirizzi IPv6 interni.

Annotazioni delle subnet personalizzate

Utilizza una delle seguenti annotazioni per indicare a un servizio LoadBalancer di utilizzare un indirizzo IP temporaneo o statico in una subnet personalizzata. Se un manifest del servizio LoadBalancer include entrambe le annotazioni, l'annotazione networking.gke.io/load-balancer-subnet ha la precedenza, a condizione che i relativi requisiti siano soddisfatti.

Annotazione e valore Requisiti e funzionalità
networking.gke.io/internal-load-balancer-subnet:
SUBNET_RESOURCE_NAME

Puoi utilizzare l'annotazione solo per specificare una subnet personalizzata per un servizio LoadBalancer interno solo IPv4. L'annotazione funziona con tutte le versioni di GKE supportate.
networking.gke.io/load-balancer-subnet:
SUBNET_RESOURCE_NAME

Puoi specificare una subnet personalizzata per un servizio LoadBalancer interno solo IPv4, solo IPv6 o dual-stack. Puoi specificare una subnet personalizzata per un servizio LoadBalancer esterno solo IPv6 o dual-stack. L'annotazione richiede GKE 1.29 o versioni successive e i seguenti requisiti aggiuntivi:

  • Per utilizzare questa annotazione per specificare una subnet personalizzata per un servizio LoadBalancer interno, il cluster deve avere il sottoinsieme GKE abilitato. Il sottoinsieme di GKE è abilitato per impostazione predefinita nelle versioni 1.36 e successive.
  • Per utilizzare questa annotazione per specificare una subnet personalizzata per un servizio External LoadBalancer, devi configurare un bilanciatore del carico basato suservizio di backendd. In GKE 1.37 e versioni successive, questa configurazione è il comportamento predefinito. Nelle versioni precedenti, devi includere il campo spec.loadBalancerClass impostato sul valore networking.gke.io/l4-regional-external nel manifest del servizio quando crei il servizio di bilanciamento del carico esterno.

Subnet e indirizzo IPv4 per un servizio Internal LoadBalancer

La tabella seguente descrive le combinazioni valide di specifica della subnet e indirizzo IPv4 per un servizio Internal Load Balancer solo IPv4 o dual-stack.

Indirizzo IPv4 statico Indirizzo IPv4 temporaneo
Subnet personalizzata
 Subnet personalizzata e indirizzo IPv4 statico: l'indirizzo IPv4 interno statico deve essere stato creato nell'intervallo di indirizzi IPv4 principale della subnet personalizzata. Subnet personalizzata e indirizzo IPv4 temporaneo: GKE utilizza un indirizzo IPv4 interno non allocato nell'intervallo di indirizzi IPv4 principale della subnet personalizzata.
Subnet del cluster Subnet del cluster e indirizzo IPv4 statico: l'indirizzo IPv4 interno statico deve essere stato creato nell'intervallo di indirizzi IPv4 principale della subnet del cluster. Subnet del cluster e indirizzo IPv4 effimero: GKE utilizza un indirizzo IPv4 interno non allocato nell'intervallo di indirizzi IPv4 principale della subnet del cluster.

Subnet e intervallo di indirizzi IPv6 per un servizio LoadBalancer interno

La tabella seguente descrive le combinazioni valide di specifica della subnet e intervallo di indirizzi IPv6 per un servizio Internal Load Balancer solo IPv6 o dual-stack. Anche se la regola di forwarding IPv6 del bilanciatore del carico di rete passthrough interno utilizza un intervallo di indirizzi IPv6 /96 interno, GKE configura i nodi in modo che accettino solo i pacchetti le cui destinazioni corrispondono al primo indirizzo IPv6 (/128) dell'intervallo /96 della regola di forwarding.

Intervallo di indirizzi IPv6 statici Intervallo di indirizzi IPv6 effimeri
Subnet dual stack personalizzata
  • Deve trovarsi nella stessa rete VPC e nella stessa regione del cluster.
  • Deve avere un intervallo di indirizzi IPv6 interno (tipo di accesso INTERNAL).
  • Deve essere specificato utilizzando l'annotazione networking.gke.io/load-balancer-subnet.
 Subnet personalizzata e intervallo di indirizzi IPv6 statici: l'intervallo di indirizzi IPv6 /96 interni statici deve essere stato creato nell'intervallo di indirizzi IPv6 /64 interni della subnet personalizzata. Subnet personalizzata e intervallo di indirizzi IPv6 temporaneo: GKE utilizza un intervallo di indirizzi IPv6 /96 interno non allocato dall'intervallo di indirizzi IPv6 /64 interno della subnet personalizzata.
Subnet dual stack del cluster
  • Deve avere un intervallo di indirizzi IPv6 interno (tipo di accesso INTERNAL).
 Intervallo di indirizzi IPv6 statici e subnet del cluster: l'intervallo di indirizzi IPv6 /96 interni statici deve essere stato creato nell'intervallo di indirizzi IPv6 /64 interni della subnet del cluster. Intervallo di indirizzi IPv6 effimeri e subnet del cluster: GKE utilizza un intervallo di indirizzi IPv6 interni /96 non allocati dall'intervallo di indirizzi IPv6 interni /64 della subnet del cluster.

Subnet e indirizzo IPv4 per un servizio LoadBalancer esterno

Per i servizi LoadBalancer esterni solo IPv4 e dual-stack, l'indirizzo IPv4 esterno, che si tratti di un indirizzo IPv4 esterno statico o di un indirizzo IPv4 esterno temporaneo, non proviene da una subnet.

Intervallo di subnet e indirizzi IPv6 per un servizio LoadBalancer esterno

La tabella seguente descrive le combinazioni valide di specifica della subnet e intervallo di indirizzi IPv6 per un servizio LoadBalancer esterno solo IPv6 o a doppio stack. Anche se la regola di forwarding IPv6 del bilanciatore del carico di rete passthrough esterno regionale utilizza un intervallo di indirizzi IPv6 esterni /96, GKE configura solo i nodi per accettare i pacchetti le cui destinazioni corrispondono al primo indirizzo IPv6 (/128) dell'intervallo /96 della regola di forwarding.

Intervallo di indirizzi IPv6 statici Intervallo di indirizzi IPv6 effimeri
Subnet dual stack personalizzata
  • Deve trovarsi nella stessa rete VPC e nella stessa regione del cluster.
  • Deve avere un intervallo di indirizzi IPv6 esterni (tipo di accesso EXTERNAL).
  • Deve essere specificato utilizzando l'annotazione networking.gke.io/load-balancer-subnet.
 Subnet personalizzata e intervallo di indirizzi IPv6 statici: l'intervallo di indirizzi IPv6 /96 esterni statici deve essere stato creato nell'intervallo di indirizzi IPv6 /64 esterni della subnet personalizzata. Gli intervalli di indirizzi IPv6 esterni statici possono essere creati solo nel livello Premium. Intervallo di indirizzi IPv6 temporanei e subnet personalizzata: GKE utilizza un intervallo di indirizzi IPv6 /96 esterno non allocato dall'intervallo di indirizzi IPv6 /64 esterno della subnet personalizzata.
Subnet dual stack del cluster
  • Deve avere un intervallo di indirizzi IPv6 esterni (tipo di accesso EXTERNAL).
 Intervallo di indirizzi IPv6 statici e subnet del cluster: l'intervallo di indirizzi IPv6 esterni statici /96 deve essere stato creato nell'intervallo di indirizzi IPv6 esterni /64 della subnet del cluster. Gli intervalli di indirizzi IPv6 esterni statici possono essere creati solo nel livello Premium. Intervallo di indirizzi IPv6 temporanei e subnet del cluster: GKE utilizza un intervallo di indirizzi IPv6 esterni /96 non allocati dall'intervallo di indirizzi IPv6 esterni /64 della subnet del cluster.

Accesso globale

Quando l'annotazione networking.gke.io/internal-load-balancer-allow-global-access è false o non è specificata per un servizio LoadBalancer interno, GKE crea un bilanciatore del carico di rete passthrough interno con l'accesso globale disabilitato per la regola di forwarding. Quando l'accesso globale è disabilitato, i client che devono accedere al bilanciatore del carico devono trovarsi nella stessa regione e nella stessa rete VPC o in una rete connessa alla rete VPC del cluster.

Quando l'annotazione networking.gke.io/internal-load-balancer-allow-global-access è true per un servizio LoadBalancer interno, GKE abilita l'opzione di accesso globale nella regola di forwarding del bilanciatore del carico di rete passthrough interno. I client che si trovano in qualsiasi regione della rete VPC o di una rete connessa alla rete VPC del cluster possono accedere al bilanciatore del carico.

Per saperne di più su come l'accesso globale si applica ai client in una rete connessa, consulta:

Regole di forwarding per tutte le porte

Le regole di forwarding per i bilanciatori del carico di rete passthrough interni supportano cinque numeri di porta unici o tutte le porte.

In GKE, un servizio LoadBalancer interno può supportare solo fino a 100 porte nel campo spec.ports[].port del servizio. Se un servizio Internal LoadBalancer definisce fino a cinque porte, la regola di forwarding includerà queste porte specifiche. Tuttavia, se il servizio specifica più di cinque porte, la regola di forwarding verrà configurata automaticamente in modo che corrisponda a tutte le porte. Quando configuri una regola di forwarding per utilizzare tutte le porte, GKE crea solo regole firewall di autorizzazione in entrata per le porte specifiche configurate in spec.ports[].port sul servizio.

Per saperne di più sulle regole di forwarding del bilanciatore del carico di rete passthrough interno e sulle specifiche delle porte valide, consulta Regole di forwarding e specifiche delle porte.

Servizio LoadBalancer dual-stack IPv4/IPv6

Puoi creare un servizio LoadBalancer interno o esterno che può essere a stack singolo (solo IPv4 o solo IPv6) o a doppio stack. I servizi LoadBalancer a stack singolo creano una singola regola di forwarding con un indirizzo IPv4 o IPv6. I servizi LoadBalancer a doppio stack creano due regole di forwarding: una con un indirizzo IPv4 e un'altra con un indirizzo IPv6. Per creare un servizio LoadBalancer a doppio stack IPv4/IPv6, esegui il deployment su un cluster a doppio stack IPv4/IPv6 e completa una delle seguenti operazioni a seconda del tipo di bilanciatore del carico che utilizzi:

Per ogni servizio, puoi definire le specifiche ipFamilyPolicy e ipFamilies. Per saperne di più, consulta Stack doppio IPv4/IPv6.

Limitazioni dei servizi LoadBalancer dual-stack

  • I servizi LoadBalancer con indirizzi IPv6 sono supportati solo sui cluster con tipo di stack ipv4-ipv6. Per saperne di più, scopri come utilizzare un indirizzo IP a doppio stack per un cluster nativo di VPC.

  • I servizi LoadBalancer creati con un indirizzo single-stack non possono essere aggiornati a servizi dual-stack.

  • I servizi LoadBalancer creati con indirizzi dual-stack possono essere modificati in stack singolo in base alle seguenti condizioni:

    • Un servizio con ipFamilies ["IPv4","IPv6"] può essere modificato in un servizio con ipFamilies IPv4, ma non IPv6.
    • Un servizio con ipFamilies ["IPv6","IPv4"] può essere modificato in un servizio con ipFamilies IPv6, ma non IPv4.

Passaggi successivi