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 |
Indica a GKE di creare un bilanciatore del carico di rete passthrough interno. Il bilanciatore del carico utilizza i backend NEG
In tutte le altre situazioni, il bilanciatore del carico utilizza i backend dei gruppi di istanze. Per saperne di più, consulta Raggruppamento dei nodi. |
Ti consigliamo |
||
| Bilanciatore del carico di rete passthrough esterno regionale basato sui servizi di backend |
Indica a GKE di creare un bilanciatore del carico di rete passthrough esterno regionale. Il bilanciatore del carico utilizza i backend NEG
In tutte le altre situazioni, il bilanciatore del carico utilizza i backend dei gruppi di istanze. Per saperne di più, consulta Raggruppamento dei nodi. |
Ti consigliamo |
||
| 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 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 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 |
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.
|
Tutte le versioni supportate. | ||
| Indirizzi IP statici |
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. |
|
||
| 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 |
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à Per i servizi LoadBalancer interni, configura BYOIPv6 specificando una subnet interna BYOIPv6 con l'annotazione |
(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 |
GKE versione 1.18.19-gke.1400 o successive | ||
| ipFamilyPolicy |
Definisce il modo in cui GKE alloca gli indirizzi IP a un servizio.
Puoi definire Per creare un servizio LoadBalancer IPv6 a stack singolo in un cluster a doppio stack, imposta il valore di questo campo su |
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) |
Definisce la famiglia di indirizzi IP per l'allocazione di servizi a stack singolo o doppio. Utilizza uno dei seguenti valori:
Per un servizio LoadBalancer IPv6 a stack singolo in un cluster a doppio stack, imposta il valore di questo campo su |
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 |
Local |
Puoi selezionare una porta personalizzata utilizzando
|
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, utilizzandokube-proxyeiptables(su cluster che non utilizzano GKE Dataplane V2) ocilium-agente regole eBPF (su cluster con GKE Dataplane V2). Se il servizio non includeloadBalancerSourceRanges[], 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'intervallo2001:db8::/32). GKE crea una regola firewall separata per la regola di forwarding IPv6 del servizio. Se il servizio non include il campoloadBalancerSourceRanges[], 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
|
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:
|
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 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:
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 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 |
| 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 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.loadBalancerClassimpostato sul valorenetworking.gke.io/l4-regional-externalnel 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 IPv6INTERNAL(ULA) o quando esegui il deployment di un servizio LoadBalancer interno su un cluster la cui subnet del nodo utilizza il tipo di accesso IPv6EXTERNAL(GUA). La subnet specificata da questa annotazione deve avere un tipo di accesso IPv6 (EXTERNALoINTERNAL) 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
|
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
|
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
|
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
|
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
|
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:
- Accesso client nella documentazione del bilanciatore del carico di rete passthrough interno
- Bilanciatori del carico di rete passthrough interni e reti connesse
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 i servizi LoadBalancer interni, devi attivare il subsetting GKE. La suddivisione in sottoinsiemi GKE è abilitata per impostazione predefinita per i cluster IPv6 a stack singolo e a doppio stack. Per saperne di più, consulta la sezione sull'abilitazione della suddivisione in sottoinsiemi del bilanciatore del carico interno.
- Per i servizi LoadBalancer esterni, devi utilizzare un bilanciatore del carico di rete passthrough esterno regionale basato su un servizio di backend. Per saperne di più, consulta Bilanciatore del carico di rete esterno basato su servizi di backend.
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 ipFamiliesIPv4, ma nonIPv6. - Un servizio con ipFamilies
["IPv6","IPv4"]può essere modificato in un servizio con ipFamiliesIPv6, ma nonIPv4.
- Un servizio con ipFamilies
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.loadBalancerIPper specificare un indirizzo IPv6. Utilizza invece l'annotazionenetworking.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.ipFamiliessuIPv4o l'impostazione del valore del campospec.ipFamilyPolicysuRequireDualStackviene rifiutata. - Puoi utilizzare l'annotazione
networking.gke.io/ip-collection-v6solo sui servizi LoadBalancer esterni IPv6 a stack singolo in GKE versione 1.37.1-gke.2097000 e successive. GKE non supporta l'annotazionenetworking.gke.io/ip-collection-v6per i servizi dual-stack, i servizi IPv4 o i servizi LoadBalancer interni e non puoi combinare questa annotazione con l'annotazionenetworking.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
- Scopri di più sui servizi LoadBalancer.
- Scopri come configurare un bilanciatore del carico interno.
- Leggi una panoramica di Ingress per i bilanciatori del carico delle applicazioni.
- Scopri come utilizzare i NEG autonomi.
- Scopri di più sulle regole firewall VPC.