Auf dieser Seite werden Parameter für Dienstmanifeste beschrieben, die das Verhalten und die Konfiguration des LoadBalancer-Dienstes steuern. Machen Sie sich vor dem Lesen dieser Seite mit den Konzepten der LoadBalancer-Dienste für Google Kubernetes Engine (GKE) vertraut.
Dienstparameter
GKE unterstützt die folgenden Parameter für LoadBalancer-Dienste.
| Parameter | Dienstfeld und -beschreibung | Intern | Extern | Versionsunterstützung |
|---|---|---|---|---|
| Interner Passthrough-Network-Load-Balancer |
Weist GKE an, einen internen Passthrough-Network-Load-Balancer zu erstellen. Der Load Balancer verwendet
In allen anderen Situationen verwendet der Load Balancer Instanzgruppen-Backends. Weitere Informationen finden Sie unter Knotengruppierung. |
Wir empfehlen |
||
| Backend-Dienst-basierter regionaler externer Passthrough-Network-Load-Balancer |
Weist GKE an, einen regionalen externen Passthrough-Network-Load-Balancer zu erstellen. Der Load Balancer verwendet
In allen anderen Situationen verwendet der Load Balancer Instanzgruppen-Backends. Weitere Informationen finden Sie unter Knotengruppierung. |
Wir empfehlen |
||
| Gewichtetes Load Balancing | networking.gke.io/weighted-load-balancing: "pods-per-node"
Ermöglicht Knoten mit mehr Bereitstellungs-Pods, einen größeren Anteil neuer Verbindungen zu erhalten als Knoten mit weniger Bereitstellungs-Pods. |
GKE 1.31.0+ | ||
| Richtlinie für internen Traffic | spec.internalTrafficPolicy
Wenn der Wert Dieser Parameter wird nicht für Cluster unterstützt, auf denen GKE Dataplane V2 ausgeführt wird. |
GKE ab Version 1.22 | ||
| Richtlinie für externen Traffic | spec.externalTrafficPolicy
Steuert, welche Knoten-VMs Systemdiagnosen des Load-Balancers bestehen und wie Pakete an Bereitschafts- und Bereitstellungs-Pods im Cluster weitergeleitet werden. Steuert auch, wie Knoten in Weitere Informationen finden Sie unter Konzepte des LoadBalancer-Dienstes. |
GKE 1.14 und höher (1.23.4-gke.400 und höher für Windows-Knotenpool) | ||
| Zonale Affinität | spec.trafficDistribution: PreferSameZone
Aktiviert die zonale Affinität für interne LoadBalancer-Dienste. Die zonale Affinität steuert die Zone, an die der interne Passthrough-Network Load Balancer eingehenden Traffic für kompatible Clients weiterleitet, wenn eine zonale Übereinstimmung möglich ist. Wenn Sie die zonale Affinität verwenden möchten, müssen Sie die GKE-Teileinstellung aktivieren (standardmäßig ab GKE-Version 1.36 aktiviert). Weitere Informationen finden Sie unter Zonale Affinität und Traffic-Verteilung. | Vorabversion in GKE 1.33.3-gke.1392000 und höher. Allgemein verfügbar in GKE-Version 1.36 und höher. | ||
| Systemdiagnose-Port | spec.healthCheckNodePort
Stellt eine Load-Balancer-Systemdiagnose für LoadBalancer-Dienste bereit. Dieser Parameter ist nur gültig, wenn |
Alle unterstützten Versionen. | ||
| Firewallregeln und Zulassungsliste für Quell-IP-Adressen | spec.loadBalancerSourceRanges
Konfiguriert optionale Firewallregeln in GKE und im der VPC-netzwerk, um nur bestimmte Quellbereiche zuzulassen
|
Alle unterstützten Versionen. | ||
| Statische IP-Adressen |
Gibt eine statische IPv4-Adresse, einen statischen IPv6-Adressbereich oder beides an, die den Weiterleitungsregeln des Load-Balancers zugewiesen sind. Wichtige Konfigurationsanforderungen und Implementierungsdetails finden Sie unter Überlegungen zur Freigabe einer gemeinsamen IP-Adresse. |
|
||
| Netzwerkdienststufen | cloud.google.com/network-tier
Gibt an, welche Netzwerkdienststufen GKE für die externe Weiterleitungsregel und IP-Adresse verwendet. Gültige Annotationswerte sind |
GKE 1.19 und höher. | ||
| Benutzerdefiniertes Subnetz | networking.gke.io/load-balancer-subnet |
(nur für IPv6) |
GKE 1.29 und höher. Weitere Anforderungen finden Sie unter Benutzerdefinierte Subnetzannotation. | |
| Eigene IPv6-Adressen verwenden (BYOIPv6) | networking.gke.io/ip-collection-v6: "projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME"
Gibt ein regionales IPv6-Unterpräfix eines öffentlich delegierten Präfixes (PDP) im Konfigurieren Sie für interne LoadBalancer-Dienste BYOIPv6, indem Sie ein internes BYOIPv6-Subnetz mit der Annotation |
(gilt nur für Single-Stack-IPv6) |
GKE-Version 1.37.1-gke.2097000 und höher | |
| Globaler Zugriff | networking.gke.io/internal-load-balancer-allow-global-access: "true"
Ermöglicht, dass die IP-Adresse der Weiterleitungsregel für Clients in jeder Region des VPC-Netzwerks oder eines angeschlossenen Netzwerks zugänglich ist. |
Vorschau in GKE 1.16 und höher. Allgemein verfügbar in GKE 1.17.9-gke.600 und höher. | ||
| Alle Ports | GKE konfiguriert die Weiterleitungsregel automatisch für die Verwendung aller Ports, wenn in |
GKE-Version 1.18.19-gke.1400 oder höher | ||
| ipFamilyPolicy |
Definiert, wie GKE einem Service IP-Adressen zuweist.
Sie können Wenn Sie einen Single-Stack-IPv6-LoadBalancer-Dienst in einem Dual-Stack-Cluster erstellen möchten, legen Sie den Wert dieses Felds auf |
GKE-Cluster in Version 1.29 oder höher unterstützen Dual-Stack-Netzwerke für LoadBalancer-Dienste.
Single-Stack-IPv6-LoadBalancer-Dienste sind in der Vorabversion in GKE-Version 1.36.0-gke.2646000 und höher verfügbar. |
||
| ipFamilies (optional) |
Definiert die IP-Adressfamilie, um entweder Single-Stack- oder Dual-Stack-Dienste zuzuweisen. Verwende einen der folgenden Werte:
Legen Sie für einen Single-Stack-IPv6-LoadBalancer-Dienst in einem Dual-Stack-Cluster den Wert dieses Felds auf |
GKE-Cluster in Version 1.29 oder höher unterstützen Dual-Stack-Netzwerke für LoadBalancer-Dienste.
Vorabversion in GKE-Version 1.36.0-gke.2646000 und höher für Single-Stack-IPv6-LoadBalancer-Dienste. |
Systemdiagnose-Port
Wie unter Load-Balancer-Systemdiagnosen beschrieben, stellt GKE immer eine Load-Balancer-Systemdiagnose bereit, wenn ein regionaler externer Passthrough-Network-Load-Balancer oder ein interner Passthrough-Network-Load-Balancer erstellt wird.
Ob Sie den Parameter healthCheckNodePort einrichten können, hängt von der folgenden externalTrafficPolicy-Konfiguration ab:
externalTrafficPolicy |
Systemdiagnose-Port |
|---|---|
Cluster |
Sie können |
Local |
Sie können einen benutzerdefinierten Port mit |
Firewallregeln und Zulassungsliste für Quell-IP-Adressen
Wenn Sie einen Cluster nicht so konfiguriert haben, dass das Erstellen von VPC-Firewallregeln für LoadBalancer-Dienste übersprungen wird, erstellt GKE für jeden Dienst eine VPC-Firewallregel, die eingehenden Traffic zulässt.
Jede automatisch erstellte Firewallregel hat die folgenden Eigenschaften:
- Die Richtung der Firewallregel ist „ingress” und ihre Aktion ist „allow”. Die implizierte Firewallregel zum Ablehnen von eingehendem Traffic in Cloud de Confiancebedeutet, dass GKE ein Modell auf der Zulassungsliste verwendet, wenn Sie Firewallregeln für eingehenden Traffic erstellen.
- GKE legt das Protokoll und den Zielport der Firewallregel auf diejenigen fest, die in der
spec.ports[]-Liste des Dienstes angegeben sind. - GKE konfiguriert Firewallregeln für LoadBalancer-Dienste, indem der Zielparameter explizit auf die virtuelle IP-Adresse des Load Balancers (die Weiterleitungsregel des Load Balancers) festgelegt wird.
- GKE legt den Zielparameter der Firewallregel so fest, dass alle Knoten des Clusters enthalten sind.
- Wenn der Dienst
spec.loadBalancerSourceRanges[]enthält, legt GKE den Quellparameter der Firewallregel auf die IP-Adressen in dieser Liste fest. Darüber hinaus konfiguriert GKE Routen und Regeln im Betriebssystem des Knotens, um die Quell-IP-Adressen für Traffic mit Load Balancing zu begrenzen. Dazu werdenkube-proxyundiptables(in Clustern, die GKE Dataplane V2 nicht verwenden) odercilium-agentund eBPF-Regeln (in Clustern mit GKE Dataplane V2) verwendet. Wenn der ServiceloadBalancerSourceRanges[]nicht enthält, legt GKE den Quellparameter der Firewallregel auf alle IP-Adressen(0.0.0.0/0)fest. - Geben Sie für einen IPv6-LoadBalancer-Dienst IPv6-CIDR-Bereiche im Feld
spec.loadBalancerSourceRanges[]an (z. B. den Bereich2001:db8::/32). GKE erstellt eine separate Firewallregel für die IPv6-Weiterleitungsregel des Dienstes. Wenn der Dienst das FeldloadBalancerSourceRanges[]nicht enthält, legt GKE den Quellparameter dieser Firewallregel auf alle IPv6-Adressen(::/0)fest.
Statische IP-Adressen
Sie können eine statische IP-Adresse erstellen und GKE so konfigurieren, dass diese der Weiterleitungsregel des Load-Balancers zugewiesen wird. Durch die Verwendung einer statischen IP-Adresse wird sichergestellt, dass die IP-Adresse des Load Balancers gleich bleibt, auch wenn Sie Änderungen am LoadBalancer-Dienst vornehmen.
Ohne eine statische IP-Adresse weist GKE der Weiterleitungsregel des Load-Balancers möglicherweise eine andere IP-Adresse zu, wenn Sie einen LoadBalancer-Dienst aktualisieren. Die IP-Adresse der Weiterleitungsregel ist nicht mit der Adresse spec.clusterIP des Dienstes identisch. Die ClusterIP-Adresse für einen Dienst ändert sich nie, wenn Sie einen LoadBalancer-Dienst aktualisieren.
Parameter für statische IP-Adressen
Um einen LoadBalancer-Dienst anzuweisen, eine statische IP-Adresse zu verwenden, verwenden Sie entweder den Parameter spec.loadBalancerIP oder die Annotation networking.gke.io/load-balancer-ip-addresses. Ab GKE-Version 1.29 hat die Annotation Vorrang vor spec.loadBalancerIP, wenn das Dienstmanifest sowohl den Parameter als auch die Annotation enthält.
| Parameter oder Annotation und Wert | Anforderungen und Funktionen |
|---|---|
spec.loadBalancerIP:IPv4_ADDRESS
|
Sie können eine statische interne IPv4-Adresse für einen reinen IPv4-LoadBalancer-Dienst angeben. Sie können eine statische externe IPv4-Adresse für einen reinen IPv4-LoadBalancer-Dienst angeben. Der Parameter funktioniert mit allen unterstützten GKE-Versionen. |
networking.gke.io/load-balancer-ip-addresses:IP_ADDRESS_RESOURCE_NAME
|
Sie können eine statische IPv4-Adresse, einen statischen IPv6-Adressbereich oder beides für reine IPv4-, nur IPv6- und Dual-Stack-interne und externe LoadBalancer-Dienste angeben. Für die Annotation sind GKE 1.29 oder höher und die folgenden zusätzlichen Anforderungen erforderlich:
|
Hinweise zur Freigabe einer gemeinsamen IP-Adresse
Zwei oder mehr LoadBalancer-Dienste können auf dieselbe statische IP-Adresse verweisen, wenn die Weiterleitungsregel für jeden Load-Balancer eine eindeutige Kombination aus IP-Adresse, Protokoll, Portspezifikation und Netzwerkdienststufen-Spezifikation verwendet, wie in der Tabelle in diesem Abschnitt angegeben. Außerdem:
Statische IPv6-Adressen sind tatsächlich
/96-IPv6-Adressbereiche. GKE konfiguriert jedoch nur Knoten so, dass sie Pakete an der ersten IPv6-Adresse (/128) im Bereich/96akzeptieren.Damit zwei oder mehr interne LoadBalancer-Dienste dieselbe interne IPv4-Adresse verwenden können, muss die statische IP-Adresse mit dem Zweck
SHARED_LOADBALANCER_VIPerstellt werden.
| Interner LoadBalancer-Dienst | Externer LoadBalancer-Dienst | |
|---|---|---|
| Portspezifikation | Weiterleitungsregeln für interne Passthrough-Network-Load-Balancer unterstützen bis zu fünf einzelne Portnummern oder können so konfiguriert werden, dass sie alle Ports verwenden. Wenn für einen internen LoadBalancer-Dienst mehr als fünf Weiterleitungsregeln mit derselben IP-Adresse und demselben Protokoll dürfen keine sich überschneidenden Ports haben. Das bedeutet, dass Sie nicht mehrere interne LoadBalancer-Dienste erstellen können, die dieselbe IP-Adresse, dasselbe Protokoll und dieselben Ports verwenden. Beispiel:
Weitere Informationen finden Sie unter Weiterleitungsregeln für interne Passthrough-Network-Load-Balancer, die eine gemeinsame IP-Adresse verwenden. |
Bei Clustern mit GKE-Versionen vor 1.37 erstellt GKE einen zielpoolbasierten regionalen externen Passthrough-Network Load Balancer, wenn im LoadBalancer-Dienstmanifest das Feld Weiterleitungsregeln für zielpoolbasierte regionale externe Passthrough-Network Load Balancer müssen zusammenhängende Portbereiche verwenden. Der zusammenhängende Portbereich umfasst alle Ports, die der Dienst benötigt, aber der Bereich kann auch zusätzliche Ports enthalten, die vom Dienst nicht verwendet werden. Beispiel: Ein externer LoadBalancer-Dienst, der von einem zielpoolbasierten regionalen externen Passthrough-Network Load Balancer bereitgestellt wird und in seinem Dienstmanifest die Ports 80 und 443 angibt, verwendet eine Weiterleitungsregel für den Load Balancer mit einem Portbereich von 80–443. Dieser Portbereich verhindert, dass andere externe LoadBalancer-Dienste einen der Ports 80, 443 und eine der Zahlen zwischen 80 und 443 verwenden. In Version 1.37 oder höher erstellt die GKE standardmäßig einen Backend-Dienst-basierten regionalen externen Passthrough-Network-Load-Balancer. In früheren Versionen erstellt GKE den Load Balancer, wenn das LoadBalancer-Dienstmanifest das Feld |
| Netzwerkdienststufen | Nicht konfigurierbar – interne Adressen sind immer Premium-Stufe. | Konfigurierbar für statische regionale, externe IPv4-Adressen. Statische regionale externe IPv6-Adressbereiche können nur in der Premium-Stufe erstellt werden. Die Netzwerkdienststufen-Spezifikation der statischen externen IP-Adresse muss mit einem der Folgenden übereinstimmen:
Die Standardstufe des Projekts ist Premium, sofern Sie sie nicht anders konfiguriert haben. |
Reservierung von IP-Adressen
GKE reserviert die statischen IP-Adressen, die mit der Annotation spec.loadBalancerIP oder networking.gke.io/load-balancer-ip-addresses konfiguriert wurden, nicht.
Das bedeutet, dass die IP-Adresse, die Sie Ihrem Dienst zuweisen, freigegeben werden kann, wenn der Dienst gelöscht wird.
Wenn Sie die IP-Adresse reserviert lassen möchten, müssen Sie in Ihrem Projekt manuell eine Adressressource erstellen. Die statische IP-Adresse muss die folgenden Attribute haben:
- Nur regional sein.
- Sie müssen sich in derselben Region wie der Cluster befinden.
- Sie müssen sich in derselben Netzwerkdienststufe wie der LoadBalancer-Dienst befinden.
- Einen Namen haben, der nicht den LoadBalancer-Namen, Präfixe wie
k8s-oder die UUID des Dienstes verwendet.
Wenn Sie die Adresse nicht selbst reservieren, können die Projektlogs Einträge zu Adressressourcen enthalten, die erstellt und kurz darauf entfernt wurden. Dies ist Teil der normalen Dienstbereitstellung und zu erwarten.
LoadBalancer-Subnetz
Sie können einen internen LoadBalancer-Dienst so konfigurieren, dass eine sitzungsspezifische oder statische IPv4-Adresse, ein IPv6-Adressbereich oder beides in einem benutzerdefinierten Subnetz verwendet wird, das sich in derselben Region und demselben VPC-Netzwerk wie der Cluster befindet. Verwenden Sie ein benutzerdefiniertes Subnetz für einen internen LoadBalancer-Dienst, um:
- Gruppieren Sie interne Passthrough-Network Load Balancer, die von internen LoadBalancer-Diensten aus zwei oder mehr GKE-Clustern im selben VPC-Netzwerk und in derselben Region erstellt wurden.
- Erstellen Sie interne LoadBalancer-Dienste, deren interne Passthrough-Network Load Balancer IPv4-Adressen haben, die von den IPv4-Adressen des Knotens getrennt sind.
- Erstellen Sie interne LoadBalancer-Dienste, deren interne Passthrough-Network Load Balancer IPv6-Adressbereiche haben, die von den IPv6-Adressen des Knotens und des Pods getrennt sind. Ein benutzerdefiniertes LoadBalancer-Subnetz ist obligatorisch, um interne LoadBalancer-Dienste zu unterstützen, wenn das Subnetz des Clusters einen externen IPv6-Adressbereich hat.
Sie können einen externen LoadBalancer-Dienst so konfigurieren, dass er einen sitzungsspezifischen oder statischen IPv6-Adressbereich in einem benutzerdefinierten Subnetz verwendet, das sich in derselben Region und demselben VPC-Netzwerk wie der Cluster befindet. Verwenden Sie ein benutzerdefiniertes Subnetz, um externe LoadBalancer-Dienste zu erstellen, deren regionale externe Passthrough-Network-Load-Balancer IPv6-Adressbereiche haben, die von den Knoten- und Pod-IPv6-Adressen des Clusters getrennt sind. Ein benutzerdefiniertes LoadBalancer-Subnetz ist obligatorisch, um externe LoadBalancer-Dienste zu unterstützen, wenn das Subnetz des Clusters einen internen IPv6-Adressbereich hat.
IPv6-Adressen für interne Passthrough-Network Load Balancer und regionale externe Passthrough-Network Load Balancer stammen in der Regel aus einem Subnetzbereich in Ihrem VPC-Netzwerk. Bei externen Single-Stack-IPv6-LoadBalancer-Diensten in GKE-Version 1.37.1-gke.2097000 und höher können die IPv6-Adressen stattdessen aus einem öffentlichen delegierten BYOIPv6-Präfix stammen. Wenn die Adresse aus einem Subnetz stammt, muss der IPv6-Zugriffstyp dieses Subnetzes mit dem Typ des von Ihnen erstellten Load Balancers übereinstimmen: Interne LoadBalancer-Dienste erfordern ein Subnetz mit einem internen IPv6-Adressbereich (einschließlich Subnetzen, die aus einem BYOIPv6-Präfix bereitgestellt werden) und externe LoadBalancer-Dienste erfordern ein Subnetz mit einem externen IPv6-Adressbereich. Eine Zusammenfassung dazu, wann ein benutzerdefiniertes LoadBalancer-Subnetz erforderlich ist, finden Sie unter IPv6-LoadBalancer-Dienste.
Benutzerdefinierte Subnetzannotation
Verwenden Sie die Annotation networking.gke.io/load-balancer-subnet:
SUBNET_RESOURCE_NAME, um einen LoadBalancer-Dienst anzuweisen, eine sitzungsspezifische oder statische IP-Adresse in einem benutzerdefinierten Subnetz zu verwenden, wobei SUBNET_RESOURCE_NAME der Name des benutzerdefinierten Subnetzes ist.
Sie können diese Annotation verwenden, um ein benutzerdefiniertes Subnetz für einen reinen IPv4-, reinen IPv6- oder Dual-Stack-Dienst für den internen LoadBalancer oder für einen reinen IPv6- oder Dual-Stack-Dienst für den externen LoadBalancer anzugeben.
Damit Sie die Annotation networking.gke.io/load-balancer-subnet verwenden können, müssen die folgenden Anforderungen erfüllt sein:
- Auf Ihrem Cluster muss die GKE-Version 1.29 oder höher ausgeführt werden.
- Wenn Sie ein benutzerdefiniertes Subnetz für einen internen LoadBalancer-Dienst angeben möchten, muss für Ihren Cluster die GKE-Teilmengeneinstellung aktiviert sein. GKE-Teileinstellungen sind in Version 1.36 und höher standardmäßig aktiviert.
- Wenn Sie ein benutzerdefiniertes Subnetz für einen externen LoadBalancer-Dienst angeben möchten, müssen Sie einen Backend-Dienst-basierten Load Balancer konfigurieren. In GKE-Version 1.37 und höher ist diese Konfiguration das Standardverhalten. In früheren Versionen müssen Sie das Feld
spec.loadBalancerClassmit dem Wertnetworking.gke.io/l4-regional-externalin das Dienstmanifest aufnehmen, wenn Sie den externen LoadBalancer-Dienst erstellen. - Für Single-Stack-IPv6-Cluster (erstellt mit dem Flag
--stack-type=ipv6) müssen Sie diese Annotation verwenden, wenn sich der Zugriffstyp des Load Balancers vom Zugriffstyp des Knotensubnetzes unterscheidet. Verwenden Sie diese Annotation beispielsweise, wenn Sie einen externen LoadBalancer-Dienst in einem Cluster bereitstellen, dessen Knotensubnetz den IPv6-ZugriffstypINTERNAL(ULA) verwendet, oder wenn Sie einen internen LoadBalancer-Dienst in einem Cluster bereitstellen, dessen Knotensubnetz den IPv6-ZugriffstypEXTERNAL(GUA) verwendet. Das durch diese Annotation angegebene Subnetzwerk muss einen IPv6-Zugriffstyp (EXTERNALoderINTERNAL) haben, der dem entsprechenden Load-Balancer-Typ entspricht. Alternativ kann ein externer LoadBalancer-Dienst seinen IPv6-Adressbereich aus einem öffentlich delegierten BYOIPv6-Präfix anstelle eines Subnetzes beziehen. Verwenden Sie in diesem Fall diese Annotation nicht.
Subnetz und IPv4-Adresse für einen internen LoadBalancer-Dienst
In der folgenden Tabelle werden gültige Subnetzspezifikationen und IPv4-Adresskombinationen für einen internen IPv4- oder Dual-Stack-LoadBalancer-Dienst beschrieben.
Statische IPv4-Adresse
|
Sitzungsspezifische IPv4-Adresse | |
|---|---|---|
Benutzerdefiniertes Subnetz
|
Benutzerdefiniertes Subnetz und statische IPv4-Adresse: Die statische interne IPv4-Adresse muss im primären IPv4-Adressbereich des benutzerdefinierten Subnetzes erstellt worden sein. | Benutzerdefiniertes Subnetz und sitzungsspezifische IPv4-Adresse: GKE verwendet eine nicht zugewiesene interne IPv4-Adresse im primären IPv4-Adressbereich des benutzerdefinierten Subnetzes. |
| Clustersubnetz | Clustersubnetz und statische IPv4-Adresse: Die statische interne IPv4-Adresse muss im primären IPv4-Adressbereich des Clustersubnetzes erstellt worden sein. | Clustersubnetz und sitzungsspezifische IPv4-Adresse: GKE verwendet eine nicht zugewiesene interne IPv4-Adresse im primären IPv4-Adressbereich des Clustersubnetzes. |
Subnetz und IPv6-Adressbereich für einen internen LoadBalancer-Dienst
In der folgenden Tabelle werden gültige Kombinationen von Subnetzspezifikationen und IPv6-Adressbereichen für einen internen IPv6- oder Dual-Stack-LoadBalancer-Dienst beschrieben. Obwohl die IPv6-Weiterleitungsregel des internen Passthrough-Netzwerk-Load-Balancers den internen IPv6-Adressbereich /96 verwendet, konfiguriert GKE nur Knoten so, dass Pakete akzeptiert werden, deren Ziele mit der ersten IPv6-Adresse (/128) des /96-Bereichs der Weiterleitungsregel übereinstimmen.
Statischer IPv6-Adressbereich
|
Sitzungsspezifischer IPv6-Adressbereich | |
|---|---|---|
Benutzerdefiniertes Dual-Stack- oder Nur-IPv6-Subnetz
|
Benutzerdefiniertes Subnetz und statischer IPv6-Adressbereich: Der statische interne IPv6-Adressbereich /96 muss im internen IPv6-Adressbereich /64 des benutzerdefinierten Subnetzes erstellt worden sein.
|
Benutzerdefiniertes Subnetz und sitzungsspezifischer IPv6-Adressbereich: GKE verwendet einen nicht zugewiesenen internen /96-IPv6-Adressbereich aus dem internen /64-IPv6-Adressbereich des benutzerdefinierten Subnetzes.
|
Dual-Stack- oder reines IPv6-Cluster-Subnetz
|
Clustersubnetz und statischer IPv6-Adressbereich: Der statische interne IPv6-Adressbereich /96 muss im internen IPv6-Adressbereich /64 des Clustersubnetzes erstellt worden sein.
|
Clustersubnetz und sitzungsspezifischer IPv6-Adressbereich: GKE verwendet einen nicht zugewiesenen internen /96-IPv6-Adressbereich aus dem internen /64-IPv6-Adressbereich des Clustersubnetzes.
|
Subnetz und IPv4-Adresse für einen externen LoadBalancer-Dienst
Bei externen reinen IPv4- und Dual-Stack-LoadBalancer-Diensten kommt die externe IPv4-Adresse – ob eine statische externe IPv4-Adresse oder eine sitzungsspezifische externe IPv4-Adresse – nicht aus einem Subnetz.
Subnetz- und IPv6-Adressbereich für einen externen LoadBalancer-Dienst
In der folgenden Tabelle werden die gültigen Kombinationen aus Subnetz oder Subpräfix und IPv6-Adressbereich für einen externen Single-Stack-IPv6- oder Dual-Stack-LoadBalancer-Dienst beschrieben. Obwohl die IPv6-Weiterleitungsregel des regionalen externen Passthrough-Network-Load-Balancers den externen IPv6-Adressbereich /96 verwendet, konfiguriert GKE nur Knoten so, dass Pakete akzeptiert werden, deren Ziele mit der ersten IPv6-Adresse (/128) des /96-Bereichs der Weiterleitungsregel übereinstimmen.
Statischer IPv6-Adressbereich
|
Sitzungsspezifischer IPv6-Adressbereich | |
|---|---|---|
Benutzerdefiniertes Dual-Stack- oder Nur-IPv6-Subnetz
|
Benutzerdefiniertes Subnetz und statischer IPv6-Adressbereich: Der statische externe IPv6-Adressbereich /96 muss im externen IPv6-Adressbereich /64 des benutzerdefinierten Subnetzes erstellt worden sein. Statische externe IPv6-Adressbereiche können nur in der Premium-Stufe erstellt werden.
|
Benutzerdefiniertes Subnetz und sitzungsspezifischer IPv6-Adressbereich: GKE verwendet einen nicht zugewiesenen externen /96-IPv6-Adressbereich aus dem externen /64-IPv6-Adressbereich des benutzerdefinierten Subnetzes.
|
Dual-Stack- oder reines IPv6-Cluster-Subnetz
|
Clustersubnetz und statischer IPv6-Adressbereich: Der statische externe IPv6-Adressbereich /96 muss im externen IPv6-Adressbereich /64 des Clustersubnetzes erstellt worden sein. Statische externe IPv6-Adressbereiche können nur in der Premium-Stufe erstellt werden.
|
Clustersubnetz und sitzungsspezifischer IPv6-Adressbereich: GKE verwendet einen nicht zugewiesenen externen /96-IPv6-Adressbereich aus dem externen /64-IPv6-Adressbereich des Clustersubnetzes.
|
Öffentlich delegiertes BYOIPv6-Präfix
|
BYOIPv6-Präfix und statischer IPv6-Adressbereich: Sie müssen den statischen externen IPv6-Adressbereich /96 aus dem regionalen Unterpräfix mit den Flags --endpoint-type=NETLB und --ip-collection reservieren und die statische Adresse mit der Annotation networking.gke.io/load-balancer-ip-addresses referenzieren. Optional können Sie auch die Annotation networking.gke.io/ip-collection-v6 angeben. Wenn Sie dies tun, muss diese Annotation auf dasselbe Unterpräfix verweisen, aus dem Sie die statische Adresse reserviert haben.
|
BYOIPv6-Präfix und sitzungsspezifischer IPv6-Adressbereich: Geben Sie das regionale Unterpräfix mit der Annotation networking.gke.io/ip-collection-v6 an.
Die GKE weist einen verfügbaren externen /96-IPv6-Adressbereich aus dem Unterpräfix zu.
|
Globaler Zugriff
Wenn die Annotation networking.gke.io/internal-load-balancer-allow-global-access für einen internen LoadBalancer-Dienst false ist oder nicht angegeben ist, erstellt GKE einen internen Passthrough-Network-Load-Balancer, dessen Weiterleitungsregel den globalen Zugriff deaktiviert hat. Wenn der globale Zugriff deaktiviert ist, müssen sich Clients, die auf den Load Balancer zugreifen müssen, in derselben Region und demselben VPC-Netzwerk oder in einem Netzwerk befinden, das mit dem VPC-Netzwerk des Clusters verbunden ist.
Wenn die Annotation networking.gke.io/internal-load-balancer-allow-global-access für einen internen LoadBalancer-Dienst true lautet, aktiviert GKE die globale Zugriffsoption für die Weiterleitungsregel des internen Passthrough-Network-Load-Balancers.
Clients, die sich in einer beliebigen Region des VPC-Netzwerks oder einem Netzwerk befinden, das mit dem VPC-Netzwerk des Clusters verbunden ist, können auf den Load-Balancer zugreifen.
Weitere Informationen zum globalen Zugriff gelten für Clients in einem verbundenen Netzwerk:
- Clientzugriff in der Dokumentation zum internen Passthrough-Network-Load-Balancer
- Interne Passthrough-Network-Load-Balancer und verbundene Netzwerke
Alle Portweiterleitungsregeln
Weiterleitungsregeln für interne Passthrough-Network-Load-Balancer unterstützen fünf eindeutige Portnummern oder alle Ports.
In GKE kann ein interner LoadBalancer-Dienst nur bis zu 100 Ports im spec.ports[].port des Dienstes unterstützen. Wenn ein interner LoadBalancer-Dienst bis zu fünf Ports definiert, enthält die Weiterleitungsregel diese spezifischen Ports. Wenn der Dienst jedoch mehr als fünf Ports angibt, wird die Weiterleitungsregel automatisch so konfiguriert, dass sie mit allen Ports übereinstimmt. Wenn Sie eine Weiterleitungsregel für die Verwendung aller Ports konfigurieren, erstellt GKE nur Firewallregeln für zulässigen eingehenden Traffic für die spezifischen Ports, die in spec.ports[].port für den Service konfiguriert sind.
Weitere Informationen zu Weiterleitungsregeln des internen Passthrough-Network-Load-Balancers und zu gültigen Portspezifikationen finden Sie unter Weiterleitungsregeln und Portspezifikationen.
IPv4/IPv6-Dual-Stack-LoadBalancer-Dienst
Sie können einen internen oder externen LoadBalancer-Dienst erstellen, der Single-Stack (nur IPv4 oder nur IPv6) oder Dual-Stack sein kann. Single-Stack-LoadBalancer-Dienste erstellen eine einzelne Weiterleitungsregel mit entweder einer IPv4-Adresse oder einer IPv6-Adresse. Dual-Stack-LoadBalancer-Dienste erstellen zwei Weiterleitungsregeln: eine mit einer IPv4-Adresse und eine mit einer IPv6-Adresse. Wenn Sie einen IPv4/IPv6-Dual-Stack-LoadBalancer-Dienst erstellen möchten, stellen Sie ihn in einem IPv4/IPv6-Dual-Stack-Cluster bereit und führen Sie je nach verwendetem Load-Balancer-Typ einen der folgenden Schritte aus:
- Für interne LoadBalancer-Dienste muss die GKE-Teilmengeneinstellung aktiviert sein. Die GKE-Teilmengeneinstellung ist standardmäßig für IPv6-Einzelstack- und Dual-Stack-Cluster aktiviert. Weitere Informationen finden Sie unter Teilmengeneinstellung der internen Load Balancer.
- Für externe LoadBalancer-Dienste müssen Sie einen Backend-Dienst-basierten regionalen externen Passthrough-Network-Load-Balancer verwenden. Weitere Informationen finden Sie unter Backend-Dienst-basierter externer Network Load Balancer.
Für jeden Dienst können Sie die Spezifikationen ipFamilyPolicy und ipFamilies definieren. Weitere Informationen finden Sie unter IPv4/IPv6-Dual-Stack.
Einschränkungen von Dual-Stack-LoadBalancer-Diensten
- LoadBalancer-Dienste mit IPv6-Adressen werden in Clustern mit dem Stacktyp
ipv4nicht unterstützt. Weitere Informationen finden Sie unter Dual-Stack-IP-Adresse für einen VPC-nativen Cluster verwenden oder Single-Stack-IPv6-Cluster konfigurieren. LoadBalancer-Dienste, die mit einer Single-Stack-Adresse erstellt wurden, können nicht auf Dual-Stack-Dienste aktualisiert werden.
LoadBalancer-Dienste, die mit Dual-Stack-Adressen erstellt wurden, können unter den folgenden Bedingungen in einen einzelnen Stack geändert werden:
- Ein Dienst mit ipFamilies
["IPv4","IPv6"]kann in einen Dienst mit ipFamiliesIPv4, aber nicht inIPv6geändert werden. - Ein Dienst mit ipFamilies
["IPv6","IPv4"]kann in einen Dienst mit ipFamiliesIPv6, aber nicht inIPv4geändert werden.
- Ein Dienst mit ipFamilies
IPv6-LoadBalancer-Dienste
Ein IPv6-LoadBalancer-Dienst ist ein LoadBalancer-Dienst, dessen Weiterleitungsregel eine IPv6-Adresse hat. Ein Service kann ein Single-Stack-IPv6-Service oder ein Dual-Stack-Service mit einer IPv4- und einer IPv6-Weiterleitungsregel sein. Wenn Sie einen Single-Stack-IPv6-LoadBalancer-Dienst in einem Dual-Stack-Cluster erstellen möchten, setzen Sie den Wert des Felds spec.ipFamilyPolicy auf SingleStack und den Wert des Felds spec.ipFamilies auf IPv6. In einem IPv6-Cluster sind dies die Standardwerte und Sie können sie weglassen.
IPv6-LoadBalancer-Dienste verwenden immer GCE_VM_IP-NEG-Back-Ends und ihre IPv6-Adressen stammen aus einem Subnetzbereich in Ihrem VPC-Netzwerk oder aus einem öffentlich delegierten Präfix für Bring Your Own IPv6 (BYOIPv6).
Single-Stack-IPv6-LoadBalancer-Dienste sind in der Vorabversion in GKE-Version 1.36.0-gke.2646000 und höher verfügbar.
Einschränkungen von IPv6-LoadBalancer-Diensten
- Sie können das Feld
spec.loadBalancerIPnicht verwenden, um eine IPv6-Adresse anzugeben. Verwenden Sie stattdessen die Annotationnetworking.gke.io/load-balancer-ip-addresses. - Externe IPv6-LoadBalancer-Dienste, einschließlich statischer externer IPv6-Adressbereiche, werden nur in der Premium-Stufe unterstützt. GKE lehnt externe IPv6-LoadBalancer-Dienste ab, die die Annotation
cloud.google.com/network-tier: Standardfestlegen. - Sie können einen Single-Stack-IPv6-LoadBalancer-Dienst nicht so ändern, dass er eine IPv4-Adresse verwendet. Das Festlegen des Werts des Felds
spec.ipFamiliesaufIPv4oder des Werts des Feldsspec.ipFamilyPolicyaufRequireDualStackwird abgelehnt. - Sie können die Annotation
networking.gke.io/ip-collection-v6nur für Single-Stack-IPv6-externe LoadBalancer-Dienste in GKE-Version 1.37.1-gke.2097000 und höher verwenden. GKE unterstützt die Annotationnetworking.gke.io/ip-collection-v6nicht für Dual-Stack-Dienste, IPv4-Dienste oder interne LoadBalancer-Dienste. Sie können diese Annotation nicht mit der Annotationnetworking.gke.io/load-balancer-subnetkombinieren.
Subnetz für den Load Balancer auswählen
Der IPv6-Zugriffstyp des Subnetzes, das die IP-Adresse des Load Balancers bereitstellt, muss mit dem Typ des Load Balancers übereinstimmen. Wenn das Subnetz des Clusters bereits den erforderlichen Zugriffstyp hat, verwendet GKE das Subnetz des Clusters. Andernfalls müssen Sie ein benutzerdefiniertes LoadBalancer-Subnetz mit dem erforderlichen Zugriffstyp erstellen und dieses Subnetz mit der Annotation networking.gke.io/load-balancer-subnet angeben. Die einzige Ausnahme ist ein externer LoadBalancer-Dienst, der ein öffentlich delegiertes BYOIPv6-Präfix verwendet, da dieses Präfix den IPv6-Adressbereich unabhängig vom Zugriffstyp des Clustersubnetzes bereitstellt.
In der folgenden Tabelle wird zusammengefasst, welches Subnetz oder Präfix den IPv6-Adressbereich des Load Balancers bereitstellt:
| LoadBalancer-Diensttyp | IPv6-Zugriffstyp des Subnetzes des Clusters | Quelle des IPv6-Adressbereichs des Load Balancers |
|---|---|---|
| Intern | INTERNAL |
Das Subnetz des Clusters. Es ist keine Annotation erforderlich. |
| Intern | EXTERNAL |
Ein benutzerdefiniertes LoadBalancer-Subnetz mit dem IPv6-Zugriffstyp INTERNAL, angegeben mit der Annotation networking.gke.io/load-balancer-subnet. |
| Intern mit BYOIPv6 | INTERNAL oder EXTERNAL |
Ein Subnetz, dessen interner IPv6-Adressbereich aus einem öffentlich delegierten BYOIPv6-Präfix im INTERNAL_IPV6_SUBNETWORK_CREATION-Modus stammt, der mit der Annotation networking.gke.io/load-balancer-subnet angegeben wird (wenn dieses Subnetz das Subnetz des Clusters ist, ist keine Annotation erforderlich). |
| Extern | EXTERNAL |
Das Subnetz des Clusters. Es ist keine Annotation erforderlich. |
| Extern | INTERNAL |
Ein benutzerdefiniertes LoadBalancer-Subnetz mit dem IPv6-Zugriffstyp EXTERNAL, angegeben mit der Annotation networking.gke.io/load-balancer-subnet. |
| Extern mit BYOIPv6 (GKE 1.37.1-gke.2097000 und höher) |
INTERNAL oder EXTERNAL |
Ein öffentlich delegiertes BYOIPv6-Präfix im Modus EXTERNAL_IPV6_FORWARDING_RULE_CREATION, das mit der Annotation networking.gke.io/ip-collection-v6 oder durch eine statische IPv6-Adresse angegeben wird, die aus dem Präfix reserviert wurde. Geben Sie die Annotation networking.gke.io/load-balancer-subnet nicht an. |
Gültige Kombinationen von Subnetz und IPv6-Adressbereich finden Sie unter Subnetz und IPv6-Adressbereich für einen internen LoadBalancer-Dienst und Subnetz und IPv6-Adressbereich für einen externen LoadBalancer-Dienst.
Eigene IPv6-Adressen verwenden (Bring your own IPv6, BYOIPv6)
Sie können Bring your own IPv6-Adressen (BYOIPv6) sowohl mit internen als auch mit externen IPv6-LoadBalancer-Diensten verwenden.
Für externe LoadBalancer-Dienste, die Adressen direkt aus einem öffentlichen delegierten Präfix zuweisen, benötigt der GKE-Dienst-Agent (service-PROJECT_NUMBER@container-engine-robot.s3ns-system.iam.gserviceaccount.com) bestimmte IAM-Berechtigungen (Identity and Access Management). Weisen Sie diesem Agenten die Rolle „Compute Public-IP-Administrator“ (roles/compute.publicIpAdmin) für das Projekt zu, dem das öffentlich delegierte Präfix gehört. Diese Rolle umfasst die Berechtigung compute.publicDelegatedPrefixes.use.
GKE benötigt diese Berechtigung sowohl bei der ersten Erstellung des Dienstes als auch bei jeder Synchronisierung des Dienstes.
Externe LoadBalancer-Dienste (GKE-Version 1.37.1-gke.2097000 und höher): Externe Single-Stack-IPv6-LoadBalancer-Dienste (spec.ipFamilyPolicy: SingleStack und spec.ipFamilies: ["IPv6"]) weisen externe /96-BYOIPv6-Adressbereiche direkt aus einem regionalen IPv6-Subpräfix eines öffentlichen delegierten Präfixes (PDP) zu. GKE unterstützt dieses Feature sowohl auf Single-Stack-IPv6-Clustern als auch auf Dual-Stack-Clustern, sofern der Dienst ein Single-Stack-IPv6-Dienst ist. Das Subnetz des Clusters kann entweder einen internen oder einen externen IPv6-Zugriffstyp haben, da der Adressbereich aus dem Unterpräfix und nicht aus einem Subnetz stammt.
Das regionale IPv6-Subpräfix muss die folgenden Anforderungen erfüllen:
- Mit dem Modus
EXTERNAL_IPV6_FORWARDING_RULE_CREATIONkonfiguriert - Konfiguriert mit einer zuweisbaren Präfixlänge von
/96 - Im Status „
ANNOUNCED“
Wenn Sie einen sitzungsspezifischen externen BYOIPv6-Adressbereich zuweisen möchten, geben Sie das Subpräfix in der Annotation networking.gke.io/ip-collection-v6 an (als vollständige Ressourcen-URL oder als partieller Ressourcenpfad projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME). Alternativ können Sie einen statischen externen BYOIPv6-Adressbereich verwenden, den Sie aus dem Subpräfix reserviert haben. Verwenden Sie dazu die Annotation networking.gke.io/load-balancer-ip-addresses.
Wenn Sie die Annotation networking.gke.io/ip-collection-v6 ändern, erstellt GKE die IPv6-Weiterleitungsregel mit einer neuen Adresse aus dem neuen Präfix neu, was den Traffic kurzzeitig unterbricht. Wenn Sie die Annotation entfernen, wird der Dienst auf eine von Google bereitgestellte Adresse aus einem Subnetz mit einem externen IPv6-Adressbereich zurückgesetzt. Wenn Ihr Clustersubnetz einen internen IPv6-Adressbereich verwendet, müssen Sie gleichzeitig die Annotation networking.gke.io/load-balancer-subnet hinzufügen, um Fehler zu vermeiden. Weitere Informationen finden Sie unter Eigene IPv6-Adressen (BYOIPv6) für einen externen LoadBalancer-Dienst verwenden.
Interne LoadBalancer-Dienste: IPv6-interne LoadBalancer-Dienste verwenden BYOIPv6-Adressen aus einem internen IPv6-Subnetz. Sie erstellen dieses Subnetz aus einem regionalen IPv6-Unterpräfix eines öffentlich delegierten Präfixes (PDP), das im Modus INTERNAL_IPV6_SUBNETWORK_CREATION konfiguriert ist. Weitere Informationen finden Sie unter IPv6-Unterpräfixe erstellen und verwenden.
Geben Sie zum Konfigurieren des Dienstes das BYOIPv6-Subnetz mit der Annotation networking.gke.io/load-balancer-subnet an oder verwenden Sie dieses Subnetz als Standardsubnetz des Clusters. Optional können Sie mit der Annotation networking.gke.io/load-balancer-ip-addresses eine reservierte statische interne BYOIPv6-Adresse angeben.
Interne LoadBalancer-Dienste unterstützen die Annotation networking.gke.io/ip-collection-v6 nicht. Wenn Sie diese Annotation anwenden, wird sie von GKE ignoriert und es wird ein IPCollectionV6Error-Warnereignis ausgegeben.
Weitere Informationen finden Sie unter Eigene IPv6-Adressen (BYOIPv6) für einen internen LoadBalancer-Dienst verwenden.
Nächste Schritte
- Weitere Informationen zu LoadBalancer-Diensten
- Internen Load Balancer einrichten
- Übersicht über Ingress für Application Load Balancer
- Eigenständige NEGs verwenden
- Weitere Informationen zu VPC-Firewallregeln