LoadBalancer-Dienstparameter

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
  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal
  • networking.gke.io/load-balancer-type: "Internal"

Weist GKE an, einen internen Passthrough-Network-Load-Balancer zu erstellen.

Der Load Balancer verwendet GCE_VM_IP-NEG-Back-Ends, wenn eine der folgenden Bedingungen zutrifft:

  • Das Dienstmanifest wird auf einen Cluster angewendet, für den die GKE-Teilmengeneinstellung aktiviert ist.
  • Das Service-Manifest wird auf einen Cluster angewendet, auf dem die GKE-Version 1.36 oder höher ausgeführt wird. Die GKE-Teileinstellung wird in GKE-Version 1.36 und höher automatisch aktiviert.

In allen anderen Situationen verwendet der Load Balancer Instanzgruppen-Backends. Weitere Informationen finden Sie unter Knotengruppierung.

  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal: Erfordert die GKE-Version 1.33.1-gke.1779000 oder höher und die Aktivierung von GKE-Teileinstellungen.
  • networking.gke.io/load-balancer-type: "Internal": alle unterstützten Versionen.

Wir empfehlen spec.loadBalancerClass, wenn Ihr Cluster die GKE-Version 1.33.1-gke.1779000 oder höher verwendet und die GKE-Teilmengenerstellung aktiviert ist. Dieses Attribut kann nicht mehr geändert werden, nachdem das Dienstmanifest auf einen Cluster angewendet wurde.

Backend-Dienst-basierter regionaler externer Passthrough-Network-Load-Balancer
  • Standardverhalten in GKE 1.37 und höher
  • spec.loadBalancerClass: networking.gke.io/l4-regional-external
  • cloud.google.com/l4-rbs: "enabled"

Weist GKE an, einen regionalen externen Passthrough-Network-Load-Balancer zu erstellen.

Der Load Balancer verwendet GCE_VM_IP-NEG-Back-Ends, wenn eine der folgenden Bedingungen zutrifft:

  • Der Dienst wird in einem Cluster erstellt, auf dem die GKE-Version 1.37 oder höher ausgeführt wird. Es sind keine Annotationen oder Klassen erforderlich.
  • Das Service-Manifest enthält spec.loadBalancerClass: networking.gke.io/l4-regional-external und wird auf einen Cluster angewendet, auf dem die GKE-Version 1.33.1-gke.1779000 bis 1.36 ausgeführt wird.
  • Das Dienstmanifest enthält die Annotation cloud.google.com/l4-rbs: "enabled" und wird auf einen Cluster angewendet, auf dem die GKE-Version 1.32.2-gke.1652000 bis 1.36 ausgeführt wird.

In allen anderen Situationen verwendet der Load Balancer Instanzgruppen-Backends. Weitere Informationen finden Sie unter Knotengruppierung.

  • spec.loadBalancerClass: networking.gke.io/l4-regional-external: erfordert GKE-Version 1.33.1-gke.1779000 und höher.
  • cloud.google.com/l4-rbs: "enabled": alle unterstützten Versionen.

Wir empfehlen spec.loadBalancerClass, wenn Ihr Cluster die GKE-Version 1.33.1-gke.1779000 bis 1.36 verwendet. Dieses Attribut ist unveränderlich und kann nicht mehr geändert werden, nachdem das Dienstmanifest auf einen Cluster angewendet wurde. In GKE 1.37 und höher sind für diesen Load-Balancer-Typ keine Felder erforderlich.

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 Local festgelegt ist, leitet GKE nur Pakete von Client-Pods auf einem Knoten an Bereitstellungs-Pods auf demselben Knoten weiter. Wenn der Wert Cluster festgelegt ist, leitet GKE Pakete von Client-Pods auf einem Knoten an Bereitstellungs-Pods auf einem beliebigen Knoten weiter. Weitere Informationen finden Sie unter Richtlinie für internen Traffic von Diensten.

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 GCE_VM_IP-NEGs gruppiert werden, wenn die GKE-Teileinstellung aktiviert ist.

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 spec.externalTrafficPolicy auf Local gesetzt ist.

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 kube-proxy konfiguriert auch iptables-Regeln, die den angegebenen Quellbereichen entsprechen.

Alle unterstützten Versionen.
Statische IP-Adressen
  • spec.loadBalancerIP (Nur IPv4)
  • networking.gke.io/load-balancer-ip-addresses

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.

  • spec.loadBalancerIP: Alle unterstützten Versionen
  • networking.gke.io/load-balancer-ip-addresses: GKE 1.29 und höher. Informationen zu weiteren Anforderungen für die Clusterkonfiguration oder Annotation finden Sie unter Parameter für statische IP-Adressen.
Netzwerkdienststufen cloud.google.com/network-tier

Gibt an, welche Netzwerkdienststufen GKE für die externe Weiterleitungsregel und IP-Adresse verwendet. Gültige Annotationswerte sind Standard und Premium (Standard).

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 EXTERNAL_IPV6_FORWARDING_RULE_CREATION-Modus an. Aus diesem Unterpräfix weist GKE einen sitzungsspezifischen externen /96-IPv6-Adressbereich für einen externen Single-Stack-IPv6-LoadBalancer-Dienst zu. Sie können das Unterpräfix als vollständige Ressourcen-URL oder als Teilressourcenpfad angeben, wie im Beispiel gezeigt. Wenn Sie diese Annotation ändern, erstellt GKE die IPv6-Weiterleitungsregel mit einer neuen Adresse aus dem neuen Präfix neu. 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 das Subnetz des Clusters einen internen IPv6-Adressbereich hat, fügen Sie gleichzeitig die Annotation networking.gke.io/load-balancer-subnet hinzu.

Konfigurieren Sie für interne LoadBalancer-Dienste BYOIPv6, indem Sie ein internes BYOIPv6-Subnetz mit der Annotation networking.gke.io/load-balancer-subnet angeben.


(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 spec.ports[].port mehr als fünf (bis zu 100) eindeutige Ports angegeben sind.

GKE-Version 1.18.19-gke.1400 oder höher
ipFamilyPolicy

spec.ipFamilyPolicy

Definiert, wie GKE einem Service IP-Adressen zuweist. Sie können spec.ipFamilyPolicy als SingleStack, PreferDualStack oder RequireDualStack definieren.

Wenn Sie einen Single-Stack-IPv6-LoadBalancer-Dienst in einem Dual-Stack-Cluster erstellen möchten, legen Sie den Wert dieses Felds auf SingleStack und den Wert des Felds spec.ipFamilies auf IPv6 fest. In einem IPv6-Cluster sind dies die Standardwerte, die Sie weglassen können. Weitere Informationen finden Sie unter IPv6-LoadBalancer-Dienste.

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)

spec.ipFamilies

Definiert die IP-Adressfamilie, um entweder Single-Stack- oder Dual-Stack-Dienste zuzuweisen. Verwende einen der folgenden Werte:

  • IPv4 nur für Single-Stack-IPv4-Dienste.
  • IPv6 nur für IPv6-Dienste.
  • IPv4,IPv6 für einen Dual-Stack-Dienst, bei dem die primäre IP-Adresse des Dienstes IPv4 ist.
  • IPv6,IPv4 für einen Dual-Stack-Dienst, bei dem die primäre IP-Adresse des Dienstes IPv6 ist.

Legen Sie für einen Single-Stack-IPv6-LoadBalancer-Dienst in einem Dual-Stack-Cluster den Wert dieses Felds auf IPv6 und den Wert des Felds spec.ipFamilyPolicy auf SingleStack fest. In einem reinen IPv6-Cluster sind dies die Standardwerte und Sie können sie weglassen. Weitere Informationen finden Sie unter IPv6-LoadBalancer-Dienste.

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 spec.healthCheckNodePort nicht verwenden.

Local

Sie können einen benutzerdefinierten Port mit spec.healthCheckNodePort auswählen. Wenn nicht angegeben, weist die Kubernetes-Steuerungsebene einen Systemdiagnoseport aus dem Knotenportbereich zu.

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 werden kube-proxy und iptables (in Clustern, die GKE Dataplane V2 nicht verwenden) oder cilium-agent und eBPF-Regeln (in Clustern mit GKE Dataplane V2) verwendet. Wenn der Service loadBalancerSourceRanges[] 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 Bereich 2001:db8::/32). GKE erstellt eine separate Firewallregel für die IPv6-Weiterleitungsregel des Dienstes. Wenn der Dienst das Feld loadBalancerSourceRanges[] 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
  • Legen Sie für Single-Stack-LoadBalancer-Dienste den Wert der Annotation auf den Namen der IPv4- oder IPv6-Adressressource fest, nicht auf die IP-Adresse selbst.
  • Legen Sie für Dual-Stack-LoadBalancer-Dienste den Wert der Annotation auf den statischen IPv4-Adressressourcennamen und den statischen IPv6-Adressbereichsressourcennamen fest, getrennt durch ein Komma.

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:

  • Wenn Sie diese Annotation mit einem internen LoadBalancer-Dienst verwenden möchten, muss in Ihrem Cluster die GKE-Teilmengeneinstellung aktiviert sein. GKE-Teileinstellungen sind in GKE-Version 1.36 und höher standardmäßig aktiviert.
  • Wenn Sie diese Annotation mit einem externen LoadBalancer-Dienst verwenden möchten, müssen Sie beim Erstellen des externen LoadBalancer-Dienstes das Feld spec.loadBalancerClass im Dienstmanifest auf den Wert networking.gke.io/l4-regional-external setzen.
  • Für einen externen Single-Stack-IPv6-LoadBalancer-Dienst in GKE-Version 1.37.1-gke.2097000 und höher können Sie den statischen IPv6-Adressbereich auch aus einem regionalen öffentlichen delegierten BYOIPv6-Präfix im Modus EXTERNAL_IPV6_FORWARDING_RULE_CREATION reservieren.
  • Für einen internen LoadBalancer-Dienst können Sie den statischen IPv6-Adressbereich aus einem internen Subnetz reservieren, das über ein öffentlich delegiertes BYOIPv6-Präfix im Modus INTERNAL_IPV6_SUBNETWORK_CREATION bereitgestellt wird.

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 /96 akzeptieren.

  • Damit zwei oder mehr interne LoadBalancer-Dienste dieselbe interne IPv4-Adresse verwenden können, muss die statische IP-Adresse mit dem Zweck SHARED_LOADBALANCER_VIP erstellt 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 spec.ports[] angegeben sind, konfiguriert GKE die Weiterleitungsregel für den internen Passthrough-Network-Load-Balancer, sodass alle Ports verwendet werden.

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:

  • Wenn Sie einen internen LoadBalancer-Dienst mit TCP-Port 80 erstellen, können Sie keinen weiteren Dienst mit den TCP-Ports 80, 81 und 90 erstellen, da sich Port 80 überschneidet.
  • Wenn ein interner LoadBalancer-Dienst die TCP-Ports 80, 8080 und 90 verwendet, können Sie keinen weiteren Dienst mit TCP auf allen Ports erstellen, da dies ebenfalls zu sich überschneidenden Ports führen würde.

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 spec.loadBalancerClass nicht auf den Wert networking.gke.io/l4-regional-external festgelegt ist oder die Annotation cloud.google.com/l4-rbs: "enabled" nicht enthalten ist. Für Cluster mit GKE 1.37 oder höher müssen Sie spec.loadBalancerClass: "networking.gke.io/l4-regional-external-legacy" explizit festlegen, um einen zielpoolbasierten regionalen externen Passthrough-Network-Load-Balancer zu erstellen.

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 spec.loadBalancerClass mit dem Wert networking.gke.io/l4-regional-external enthält. Weiterleitungsregeln für Backend-Dienst-basierte regionale externe Passthrough-Network Load Balancer unterstützen bis zu fünf eigenständige Portnummern oder einen zusammenhängenden Portbereich.

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 in der Annotation cloud.google.com/network-tier des LoadBalancer-Dienstmanifests angegebene Stufe, wenn diese Annotation im Manifest vorhanden ist, oder
  • Die Standardstufe des Projekts, wenn die Annotation cloud.google.com/network-tier im LoadBalancer-Dienstmanifest nicht vorhanden ist.

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.loadBalancerClass mit dem Wert networking.gke.io/l4-regional-external in 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-Zugriffstyp INTERNAL (ULA) verwendet, oder wenn Sie einen internen LoadBalancer-Dienst in einem Cluster bereitstellen, dessen Knotensubnetz den IPv6-Zugriffstyp EXTERNAL (GUA) verwendet. Das durch diese Annotation angegebene Subnetzwerk muss einen IPv6-Zugriffstyp (EXTERNAL oder INTERNAL) 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
  • Muss sich im selben VPC-Netzwerk und in derselben Region wie der Cluster befinden.
  • Muss einen internen IPv6-Adressbereich haben (Zugriffstyp INTERNAL). Dies kann entweder ein von Google bereitgestellter interner IPv6-Adressbereich oder ein interner BYOIPv6-Adressbereich sein, der aus einem öffentlichen delegierten Präfix im Modus INTERNAL_IPV6_SUBNETWORK_CREATION bereitgestellt wird.
  • Muss mit der Annotation networking.gke.io/load-balancer-subnet angegeben werden.
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
  • Muss einen internen IPv6-Adressbereich haben (Zugriffstyp INTERNAL). Dies kann entweder ein von Google bereitgestellter interner IPv6-Adressbereich oder ein interner BYOIPv6-Adressbereich sein.
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
  • Muss sich im selben VPC-Netzwerk und in derselben Region wie der Cluster befinden.
  • Muss einen externen IPv6-Adressbereich haben (Zugriffstyp EXTERNAL).
  • Muss mit der Annotation networking.gke.io/load-balancer-subnet angegeben werden.
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
  • Muss einen externen IPv6-Adressbereich haben (Zugriffstyp EXTERNAL).
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
  • Gilt nur für externe Single-Stack-IPv6-LoadBalancer-Dienste in GKE-Version 1.37.1-gke.2097000 und höher.
  • Das regionale Unterpräfix muss sich in derselben Region wie der Cluster befinden, den Modus EXTERNAL_IPV6_FORWARDING_RULE_CREATION verwenden und eine zuweisbare Präfixlänge von /96 haben.
  • Das Unterpräfix muss den Status ANNOUNCED haben.
  • Funktioniert auf Einzelstack-IPv6-Clustern und auf Dual-Stack-Clustern (der Dienst selbst muss ein Einzelstack-IPv6-Dienst sein). Das Subnetz des Clusters kann entweder einen internen oder einen externen IPv6-Adressbereich haben (Zugriffstyp INTERNAL oder EXTERNAL). Es ist kein externes IPv6-Subnetz erforderlich, da der Adressbereich aus dem Unterpräfix stammt.
  • Erfordert einen Backend-Dienst-basierten regionalen externen Passthrough-Network-Load-Balancer (spec.loadBalancerClass: networking.gke.io/l4-regional-external) in der Premium-Stufe.
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:

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 ipv4 nicht 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 ipFamilies IPv4, aber nicht in IPv6 geändert werden.
    • Ein Dienst mit ipFamilies ["IPv6","IPv4"] kann in einen Dienst mit ipFamilies IPv6, aber nicht in IPv4 geändert werden.

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.loadBalancerIP nicht verwenden, um eine IPv6-Adresse anzugeben. Verwenden Sie stattdessen die Annotation networking.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: Standard festlegen.
  • 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.ipFamilies auf IPv4 oder des Werts des Felds spec.ipFamilyPolicy auf RequireDualStack wird abgelehnt.
  • Sie können die Annotation networking.gke.io/ip-collection-v6 nur für Single-Stack-IPv6-externe LoadBalancer-Dienste in GKE-Version 1.37.1-gke.2097000 und höher verwenden. GKE unterstützt die Annotation networking.gke.io/ip-collection-v6 nicht für Dual-Stack-Dienste, IPv4-Dienste oder interne LoadBalancer-Dienste. Sie können diese Annotation nicht mit der Annotation networking.gke.io/load-balancer-subnet kombinieren.

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_CREATION konfiguriert
  • 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