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 avere familiarità con i concetti relativi ai servizi LoadBalancer di Google Kubernetes Engine (GKE).

Parametri di servizio

GKE supporta i seguenti parametri per i servizi LoadBalancer.

Parametro Campo e descrizione del servizio 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 subsetting GKE.
  • Il manifest del servizio viene applicato a un cluster che esegue GKE versione 1.36 o successive. Il subsetting GKE viene abilitato 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ù, consulta Raggruppamento dei nodi.

  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal: richiede GKE 1.33.1-gke.1779000 e versioni successive e il subsetting GKE abilitato.
  • 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 l'applicazione del manifest del servizio 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 da 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ù, consulta 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 da 1.33.1-gke.1779000 a 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 pubblicazione di ricevere una percentuale maggiore di nuove connessioni rispetto ai nodi con meno pod di pubblicazione.

GKE 1.31.0+
Policy di traffico interno spec.internalTrafficPolicy

Se impostato sul valore Local, GKE instrada i pacchetti solo dai pod client su un nodo ai pod di distribuzione 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 attivi nel cluster. Controlla anche il modo in cui i nodi vengono raggruppati in NEG GCE_VM_IP quando è abilitato il subsetting GKE.

Per maggiori 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à di zona controlla la zona a cui il bilanciatore del carico di rete passthrough interno instrada il traffico in entrata per i client compatibili quando è possibile una corrispondenza di zona. Per utilizzare l'affinità di zona, devi abilitare la creazione di sottoinsiemi GKE (abilitata per impostazione predefinita dalla versione GKE 1.36 e successive).

Per saperne di più, consulta Affinità di zona e distribuzione del traffico.

Anteprima in GKE 1.33.3-gke.1392000 e versioni successive. Disponibilità 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 i parametri degli indirizzi IP statici per ulteriori requisiti di configurazione o annotazione del cluster.
Network Service Tiers cloud.google.com/network-tier

Specifica i Network Service Tiers utilizzati da GKE per la regola di forwarding e l'indirizzo IP esterni. I valori validi per l'annotazione sono Standard e Premium (predefinito).

GKE 1.19 e versioni successive.
Subnet personalizzata networking.gke.io/load-balancer-subnet
(si applica solo a IPv6)
GKE 1.29 e versioni successive. Per ulteriori requisiti, consulta Annotazione della subnet personalizzata.
Bring Your Own IPv6 (BYOIPv6) networking.gke.io/ip-collection-v6: "projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME"

Specifica un sottoprefisso IPv6 regionale di un prefisso delegato pubblico (PDP) in modalità EXTERNAL_IPV6_FORWARDING_RULE_CREATION. Da questo prefisso secondario, GKE alloca un intervallo di indirizzi IPv6 /96 esterni temporanei per un servizio LoadBalancer esterno IPv6 single-stack. Puoi specificare il sottoprefisso come URL completo della risorsa o come percorso parziale della risorsa, come mostrato nell'esempio. Se modifichi questa annotazione, GKE ricrea la regola di forwarding IPv6 con un nuovo indirizzo dal nuovo prefisso. Se rimuovi l'annotazione, il servizio torna a un indirizzo fornito da Google da una subnet con un intervallo di indirizzi IPv6 esterno; se la subnet del cluster ha un intervallo di indirizzi IPv6 interno, aggiungi contemporaneamente l'annotazione networking.gke.io/load-balancer-subnet.

Per i servizi LoadBalancer interni, configura BYOIPv6 specificando una subnet interna BYOIPv6 con l'annotazione networking.gke.io/load-balancer-subnet.


(si applica solo a IPv6 a stack singolo)
GKE versione 1.37.1-gke.2097000 e successive
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 in modo che utilizzi 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 creare un servizio LoadBalancer IPv6 a stack singolo in un cluster a doppio stack, imposta il valore di questo campo su SingleStack e il valore del campo spec.ipFamilies su IPv6. In un cluster solo IPv6, questi sono i valori predefiniti e puoi ometterli. Per saperne di più, consulta Servizi LoadBalancer IPv6.

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

I servizi LoadBalancer IPv6 a stack singolo sono disponibili in anteprima in GKE versione 1.36.0-gke.2646000 e successive.
ipFamilies (facoltativo)

spec.ipFamilies

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

  • IPv4 solo per il servizio IPv4 a 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.

Per un servizio LoadBalancer IPv6 a stack singolo in un cluster a doppio stack, imposta il valore di questo campo su IPv6 e il valore del campo spec.ipFamilyPolicy su SingleStack. In un cluster solo IPv6, questi sono i valori predefiniti e puoi ometterli. Per saperne di più, consulta Servizi LoadBalancer IPv6.

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

Anteprima in GKE versione 1.36.0-gke.2646000 e successive per i servizi LoadBalancer IPv6 a stack singolo.

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 impostare 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 di 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 di autorizzazione 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 implicite per negare il traffico in entrata in Google Cloudindicano che GKE utilizza un modello di lista consentita durante la creazione delle 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 di origine della regola firewall sugli indirizzi IP nell'elenco. Inoltre, GKE configura route e regole all'interno del sistema operativo del nodo per limitare gli indirizzi IP di origine per il traffico con bilanciamento del carico, utilizzando kube-proxy e iptables (su cluster che non utilizzano GKE Dataplane V2) o cilium-agent e regole eBPF (su 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).
  • Per un servizio LoadBalancer IPv6, specifica gli intervalli CIDR IPv6 nel campo spec.loadBalancerSourceRanges[] (ad esempio, l'intervallo 2001:db8::/32). GKE crea una regola firewall separata per la regola di forwarding IPv6 del servizio. Se il servizio non include il campo loadBalancerSourceRanges[], GKE imposta il parametro di origine della regola firewall su tutti gli indirizzi IPv6 (::/0).

Indirizzi IP statici

Puoi creare un indirizzo IP statico e configurare GKE in modo che assegni l'indirizzo statico alla regola di forwarding del bilanciatore del carico. L'utilizzo di un indirizzo IP statico contribuisce a garantire 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 Service 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 dell'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 statici separati da una virgola.

Puoi specificare un indirizzo IPv4 statico, un intervallo di indirizzi IPv6 statici o entrambi per i servizi LoadBalancer interni ed esterni 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 subsetting 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.
  • Per un servizio LoadBalancer esterno IPv6 single-stack in GKE versione 1.37.1-gke.2097000 e successive, puoi anche prenotare l'intervallo di indirizzi IPv6 statici da un prefisso BYOIPv6 delegato pubblico regionale in modalità EXTERNAL_IPV6_FORWARDING_RULE_CREATION.
  • Per un servizio LoadBalancer interno, puoi prenotare l'intervallo di indirizzi IPv6 statici da una subnet interna di cui è stato eseguito il provisioning da un prefisso delegato pubblico BYOIPv6 in modalità INTERNAL_IPV6_SUBNETWORK_CREATION.

Considerazioni sulla 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 di 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 solo per accettare pacchetti sul primo indirizzo IPv6 (/128) nell'intervallo /96.

  • Affinchì due o più servizi LoadBalancer interni utilizzino lo stesso indirizzo IPv4 interno, 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 singoli oppure possono essere configurate per utilizzare tutte le porte.

Quando un servizio LoadBalancer interno 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 protocollo non possono avere porte sovrapposte. Ciò significa che non puoi creare più servizi LoadBalancer interni che condividono lo stesso indirizzo IP, lo stesso protocollo e le stesse porte. Ad esempio:

  • Se crei un servizio LoadBalancer interno 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 LoadBalancer interno utilizza le porte TCP 80, 8080 e 90, non puoi creare un altro servizio che utilizzi TCP su tutte le porte, poiché 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 un 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 LoadBalancer esterni 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 distinti o un intervallo di porte contigue.

Network Service Tiers Non configurabile: gli indirizzi interni sono sempre di livello Premium.

Configurabile per indirizzi IPv4 esterni regionali statici. 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 lo abbia configurato diversamente.

Prenotazione degli indirizzi IP

GKE non prenota 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 l'indirizzo IP prenotato, devi creare manualmente una risorsa indirizzo nel progetto. L'indirizzo IP statico deve avere i seguenti attributi:

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

Se non prenoti l'indirizzo, i log del progetto possono contenere voci relative alle risorse di indirizzi create e rimosse poco dopo. Questo fa parte del normale provisioning del servizio ed è un comportamento previsto.

Subnet LoadBalancer

Puoi configurare un servizio LoadBalancer interno in modo che utilizzi un indirizzo IPv4 statico o temporaneo, un intervallo di indirizzi IPv6 o entrambi, in una subnet personalizzata situata nella stessa regione e nella stessa 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.
  • Crea servizi LoadBalancer interni 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 LoadBalancer interni se la subnet del cluster ha un intervallo di indirizzi IPv6 esterno.

Puoi configurare un servizio LoadBalancer esterno in modo che utilizzi un intervallo di indirizzi IPv6 statico o temporaneo 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 se la subnet del cluster ha un intervallo di indirizzi IPv6 interno.

Gli indirizzi IPv6 per i bilanciatori del carico di rete passthrough interni e i bilanciatori del carico di rete passthrough esterni regionali in genere provengono da un intervallo di subnet nella rete VPC. Per i servizi LoadBalancer esterni IPv6 a stack singolo in GKE versione 1.37.1-gke.2097000 e successive, gli indirizzi IPv6 possono invece provenire da un prefisso delegato pubblico BYOIPv6. Quando l'indirizzo proviene da una subnet, il tipo di accesso IPv6 di quella subnet deve corrispondere al tipo di bilanciatore del carico che crei: i servizi LoadBalancer interni richiedono una subnet con un intervallo di indirizzi IPv6 interno (incluse le subnet di cui è stato eseguito il provisioning da un prefisso BYOIPv6) e i servizi LoadBalancer esterni richiedono una subnet con un intervallo di indirizzi IPv6 esterno. Per un riepilogo di quando è richiesta una subnet LoadBalancer personalizzata, consulta Servizi LoadBalancer IPv6.

Annotazione della subnet personalizzata

Utilizza l'annotazione networking.gke.io/load-balancer-subnet: SUBNET_RESOURCE_NAME per indicare a un servizio LoadBalancer di utilizzare un indirizzo IP temporaneo o statico in una subnet personalizzata, dove SUBNET_RESOURCE_NAME è il nome della subnet personalizzata. Puoi utilizzare questa annotazione per specificare una subnet personalizzata per un servizio LoadBalancer interno solo IPv4, solo IPv6 o dual-stack oppure per un servizio LoadBalancer esterno solo IPv6 o dual-stack.

Per utilizzare l'annotazione networking.gke.io/load-balancer-subnet, devi soddisfare i seguenti requisiti:

  • Il cluster deve eseguire GKE versione 1.29 o successive.
  • Per specificare una subnet personalizzata per un servizio LoadBalancer interno, il cluster deve avere il subsetting GKE abilitato. La suddivisione in sottoinsiemi GKE è abilitata per impostazione predefinita nelle versioni 1.36 e successive.
  • Per specificare una subnet personalizzata per un servizio LoadBalancer esterno, devi configurare un bilanciatore del carico basato su un servizio di backend. In GKE versione 1.37 e 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 Service quando crei il Service LoadBalancer esterno.
  • Per i cluster IPv6 a stack singolo (creati con il flag --stack-type=ipv6), devi utilizzare questa annotazione quando il tipo di accesso del bilanciatore del carico è diverso dal tipo di accesso della subnet del nodo. Ad esempio, utilizza questa annotazione quando esegui il deployment di un servizio LoadBalancer esterno su un cluster la cui subnet del nodo utilizza il tipo di accesso IPv6 INTERNAL (ULA) o quando esegui il deployment di un servizio LoadBalancer interno su un cluster la cui subnet del nodo utilizza il tipo di accesso IPv6 EXTERNAL (GUA). La subnet specificata da questa annotazione deve avere un tipo di accesso IPv6 (EXTERNAL o INTERNAL) corrispondente al tipo di bilanciatore del carico. In alternativa, un servizio LoadBalancer esterno può prendere il proprio intervallo di indirizzi IPv6 da un prefisso BYOIPv6 pubblico delegato anziché da una subnet; in questo caso, non utilizzare questa annotazione.

Subnet e indirizzo IPv4 per un servizio LoadBalancer interno

La tabella seguente descrive le combinazioni valide di specifiche della subnet e indirizzi IPv4 per un servizio LoadBalancer interno 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 temporaneo: 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 specifiche della subnet e intervalli di indirizzi IPv6 per un servizio LoadBalancer interno 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 temporaneo
Subnet personalizzata a doppio stack o solo IPv6
  • Deve trovarsi nella stessa rete VPC e nella stessa regione del cluster.
  • Deve avere un intervallo di indirizzi IPv6 interni (tipo di accesso INTERNAL), che può essere un intervallo di indirizzi IPv6 interni fornito da Google o un intervallo di indirizzi interni BYOIPv6 di cui è stato eseguito il provisioning da un prefisso delegato pubblico in modalità INTERNAL_IPV6_SUBNETWORK_CREATION.
  • 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 del cluster a doppio stack o solo IPv6
  • Deve avere un intervallo di indirizzi IPv6 interni (tipo di accesso INTERNAL), che può essere un intervallo di indirizzi IPv6 interni fornito da Google o un intervallo di indirizzi interni BYOIPv6.
Subnet del cluster 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 del cluster. Subnet del cluster e intervallo di indirizzi IPv6 temporanei: GKE utilizza un intervallo di indirizzi IPv6 /96 interno non allocato dall'intervallo di indirizzi IPv6 /64 interno 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.

Subnet e intervallo di indirizzi IPv6 per un servizio LoadBalancer esterno

La tabella seguente descrive le combinazioni valide di subnet o prefisso secondario e intervallo di indirizzi IPv6 per un servizio LoadBalancer esterno IPv6 a stack singolo 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 /96 esterno, 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 temporaneo
Subnet personalizzata a doppio stack o solo IPv6
  • 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. Subnet personalizzata e intervallo di indirizzi IPv6 temporaneo: GKE utilizza un intervallo di indirizzi IPv6 /96 esterno non allocato dall'intervallo di indirizzi IPv6 /64 esterno della subnet personalizzata.
Subnet del cluster a doppio stack o solo IPv6
  • Deve avere un intervallo di indirizzi IPv6 esterni (tipo di accesso EXTERNAL).
Subnet del cluster 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 del cluster. Gli intervalli di indirizzi IPv6 esterni statici possono essere creati solo nel livello Premium. Subnet del cluster e intervallo di indirizzi IPv6 temporaneo: GKE utilizza un intervallo di indirizzi IPv6 /96 esterno non allocato dall'intervallo di indirizzi IPv6 /64 esterno della subnet del cluster.
Prefisso delegato pubblico BYOIPv6
  • Si applica solo ai servizi LoadBalancer esterni IPv6 a stack singolo in GKE versione 1.37.1-gke.2097000 e successive.
  • Il sottoprefisso regionale deve trovarsi nella stessa regione del cluster, deve utilizzare la modalità EXTERNAL_IPV6_FORWARDING_RULE_CREATION e deve avere una lunghezza del prefisso allocabile pari a /96.
  • Il prefisso secondario deve avere lo stato ANNOUNCED.
  • Funziona su cluster IPv6 a stack singolo e su cluster a doppio stack (il servizio stesso deve essere IPv6 a stack singolo). La subnet del cluster può avere un intervallo di indirizzi IPv6 interno o esterno (tipo di accesso INTERNAL o EXTERNAL); non è richiesta alcuna subnet IPv6 esterna perché l'intervallo di indirizzi proviene dal prefisso secondario.
  • Richiede un bilanciatore del carico di rete passthrough esterno regionale basato su un servizio di backend (spec.loadBalancerClass: networking.gke.io/l4-regional-external) nel livello Premium.
Prefisso BYOIPv6 e intervallo di indirizzi IPv6 statici: devi prenotare l'intervallo di indirizzi IPv6 /96 esterni statici dal sottoprefisso regionale utilizzando i flag --endpoint-type=NETLB e --ip-collection e fare riferimento all'indirizzo statico utilizzando l'annotazione networking.gke.io/load-balancer-ip-addresses. Facoltativamente, puoi anche includere l'annotazione networking.gke.io/ip-collection-v6. In questo caso, l'annotazione deve fare riferimento allo stesso prefisso secondario da cui hai prenotato l'indirizzo statico. Prefisso BYOIPv6 e intervallo di indirizzi IPv6 temporaneo: specifica il sottoprefisso regionale utilizzando l'annotazione networking.gke.io/ip-collection-v6. GKE alloca un intervallo di indirizzi IPv6 /96 esterni disponibile dal sottoprefisso.

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 attiva 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 di tutte le porte

Le regole di forwarding per i bilanciatori del carico di rete passthrough interni supportano cinque numeri di porta univoci 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 LoadBalancer interno 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 da corrispondere 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 nel 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, eseguine 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 non sono supportati sui cluster con il tipo di stack ipv4. Per saperne di più, consulta Utilizza un indirizzo IP a doppio stack per un cluster nativo di VPC o Configura un cluster IPv6 a stack singolo.
  • Non è possibile eseguire l'upgrade dei servizi LoadBalancer creati con un indirizzo a stack singolo a servizi a doppio stack.

  • I servizi LoadBalancer creati con indirizzi a doppio 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.

Servizi LoadBalancer IPv6

Un servizio LoadBalancer IPv6 è un servizio LoadBalancer la cui regola di forwarding ha un indirizzo IPv6. Un servizio può essere a stack singolo IPv6 o a doppio stack con una regola di forwarding IPv4 e una IPv6. Per creare un servizio LoadBalancer IPv6 a stack singolo in un cluster a doppio stack, imposta il valore del campo spec.ipFamilyPolicy su SingleStack e il valore del campo spec.ipFamilies su IPv6. In un cluster solo IPv6, questi sono i valori predefiniti e puoi ometterli.

I servizi LoadBalancer IPv6 utilizzano sempre backend NEG GCE_VM_IP e i loro indirizzi IPv6 provengono da un intervallo di subnet nella rete VPC o da un prefisso delegato pubblico Bring Your Own IPv6 (BYOIPv6).

I servizi LoadBalancer IPv6 single-stack sono disponibili in anteprima in GKE versione 1.36.0-gke.2646000 e successive.

Limitazioni dei servizi LoadBalancer IPv6

  • Non puoi utilizzare il campo spec.loadBalancerIP per specificare un indirizzo IPv6. Utilizza invece l'annotazione networking.gke.io/load-balancer-ip-addresses.
  • I servizi LoadBalancer IPv6 esterni, inclusi gli intervalli di indirizzi IPv6 esterni statici, sono supportati solo nel livello Premium. GKE rifiuta i servizi LoadBalancer IPv6 esterni che impostano l'annotazione cloud.google.com/network-tier: Standard.
  • Non puoi modificare un servizio LoadBalancer IPv6 a stack singolo per utilizzare un indirizzo IPv4. L'impostazione del valore del campo spec.ipFamilies su IPv4 o l'impostazione del valore del campo spec.ipFamilyPolicy su RequireDualStack viene rifiutata.
  • Puoi utilizzare l'annotazione networking.gke.io/ip-collection-v6 solo sui servizi LoadBalancer esterni IPv6 a stack singolo in GKE versione 1.37.1-gke.2097000 e successive. GKE non supporta l'annotazione networking.gke.io/ip-collection-v6 per i servizi dual-stack, i servizi IPv4 o i servizi LoadBalancer interni e non puoi combinare questa annotazione con l'annotazione networking.gke.io/load-balancer-subnet.

Scegli una subnet per il bilanciatore del carico

Il tipo di accesso IPv6 della subnet che fornisce l'indirizzo IP del bilanciatore del carico deve corrispondere al tipo di bilanciatore del carico. Se la subnet del cluster ha già il tipo di accesso richiesto, GKE utilizza la subnet del cluster. In caso contrario, devi creare una subnet LoadBalancer personalizzata con il tipo di accesso richiesto e specificarla con l'annotazione networking.gke.io/load-balancer-subnet. L'unica eccezione è un servizio LoadBalancer esterno che utilizza un prefisso delegato pubblico BYOIPv6, perché questo prefisso fornisce l'intervallo di indirizzi IPv6 indipendentemente dal tipo di accesso della subnet del cluster.

La tabella seguente riassume quale subnet o prefisso fornisce l'intervallo di indirizzi IPv6 del bilanciatore del carico:

Tipo di servizio LoadBalancer Tipo di accesso IPv6 della subnet del cluster Origine dell'intervallo di indirizzi IPv6 del bilanciatore del carico
Interno INTERNAL La subnet del cluster. Non è richiesta alcuna annotazione.
Interno EXTERNAL Una subnet LoadBalancer personalizzata con un tipo di accesso IPv6 INTERNAL, specificato con l'annotazione networking.gke.io/load-balancer-subnet.
Interno con BYOIPv6 INTERNAL o EXTERNAL Una subnet il cui intervallo di indirizzi IPv6 interni proviene da un prefisso delegato pubblico BYOIPv6 in modalità INTERNAL_IPV6_SUBNETWORK_CREATION, specificato con l'annotazione networking.gke.io/load-balancer-subnet (non è richiesta alcuna annotazione se la subnet è quella del cluster).
Esterno EXTERNAL La subnet del cluster. Non è richiesta alcuna annotazione.
Esterno INTERNAL Una subnet LoadBalancer personalizzata con un tipo di accesso IPv6 EXTERNAL, specificato con l'annotazione networking.gke.io/load-balancer-subnet.
Esterno con BYOIPv6
(GKE 1.37.1-gke.2097000 e versioni successive)
INTERNAL o EXTERNAL Un prefisso delegato pubblico BYOIPv6 in modalità EXTERNAL_IPV6_FORWARDING_RULE_CREATION, specificato con l'annotazione networking.gke.io/ip-collection-v6 o da un indirizzo IPv6 statico riservato dal prefisso. Non specificare l'annotazione networking.gke.io/load-balancer-subnet.

Per le combinazioni valide di subnet e intervallo di indirizzi IPv6, consulta Subnet e intervallo di indirizzi IPv6 per un servizio LoadBalancer interno e Subnet e intervallo di indirizzi IPv6 per un servizio LoadBalancer esterno.

Bring Your Own IPv6 (BYOIPv6)

Puoi utilizzare Porta i tuoi indirizzi IPv6 (BYOIPv6) con i servizi LoadBalancer IPv6 interni ed esterni.

Per i servizi LoadBalancer esterni, che allocano gli indirizzi direttamente da un prefisso delegato pubblico, l'agente di servizio GKE (service-PROJECT_NUMBER@container-engine-robot.) richiede autorizzazioni Identity and Access Management (IAM) specifiche. Concedi il ruolo Compute Public IP Admin (roles/compute.publicIpAdmin) a questo agente nel progetto proprietario del prefisso delegato pubblico. Questo ruolo include l'autorizzazione compute.publicDelegatedPrefixes.use.

GKE richiede questa autorizzazione sia durante la creazione iniziale del servizio sia ogni volta che sincronizza il servizio.

Servizi LoadBalancer esterni (GKE versione 1.37.1-gke.2097000 e successive): i servizi LoadBalancer esterni IPv6 a stack singolo (spec.ipFamilyPolicy: SingleStack e spec.ipFamilies: ["IPv6"]) allocano intervalli di indirizzi BYOIPv6 /96 esterni direttamente da un prefisso secondario IPv6 regionale di un prefisso delegato pubblico (PDP). GKE supporta questa funzionalità sia sui cluster IPv6 a stack singolo sia sui cluster a doppio stack, a condizione che il servizio sia IPv6 a stack singolo. La subnet del cluster può avere un tipo di accesso IPv6 interno o esterno, perché l'intervallo di indirizzi proviene dal sottoprefisso anziché da una subnet.

Il sottoprefisso IPv6 regionale deve soddisfare i seguenti requisiti:

  • Configurato con la modalità EXTERNAL_IPV6_FORWARDING_RULE_CREATION
  • Configurato con una lunghezza del prefisso allocabile di /96
  • Nello stato ANNOUNCED

Per allocare un intervallo di indirizzi BYOIPv6 esterni temporanei, specifica il prefisso secondario nell'annotazione networking.gke.io/ip-collection-v6 (fornito come URL della risorsa completo o percorso della risorsa parziale projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME). In alternativa, per utilizzare un intervallo di indirizzi BYOIPv6 esterni statici che hai prenotato dal prefisso secondario, utilizza l'annotazione networking.gke.io/load-balancer-ip-addresses.

Se modifichi l'annotazione networking.gke.io/ip-collection-v6, GKE ricrea la regola di forwarding IPv6 con un nuovo indirizzo dal nuovo prefisso, il che interrompe brevemente il traffico. Se rimuovi l'annotazione, il servizio torna a un indirizzo fornito da Google da una subnet con un intervallo di indirizzi IPv6 esterno. Se la subnet del cluster utilizza un intervallo di indirizzi IPv6 interni, per evitare errori devi aggiungere contemporaneamente l'annotazione networking.gke.io/load-balancer-subnet. Per saperne di più, consulta Utilizza Bring Your Own IPv6 (BYOIPv6) per un servizio LoadBalancer esterno.

Servizi LoadBalancer interni: i servizi LoadBalancer interni IPv6 utilizzano indirizzi BYOIPv6 di una subnet IPv6 interna. Puoi creare questa subnet da un sottoprefisso IPv6 regionale di un prefisso delegato pubblico (PDP) configurato in modalità INTERNAL_IPV6_SUBNETWORK_CREATION. Per saperne di più, consulta Crea e utilizza i prefissi secondari IPv6.

Per configurare il servizio, specifica la subnet BYOIPv6 utilizzando l'annotazione networking.gke.io/load-balancer-subnet o utilizza la subnet come subnet predefinita del cluster. Facoltativamente, specifica un indirizzo BYOIPv6 interno statico riservato utilizzando l'annotazione networking.gke.io/load-balancer-ip-addresses.

I servizi LoadBalancer interni non supportano l'annotazione networking.gke.io/ip-collection-v6. Se applichi questa annotazione, GKE la ignora ed emette un evento di avviso IPCollectionV6Error. Per saperne di più, consulta Utilizza Bring Your Own IPv6 (BYOIPv6) per un servizio LoadBalancer interno.

Passaggi successivi