Paramètres du service LoadBalancer

Cette page décrit les paramètres des fichiers manifestes des services qui contrôlent le comportement et la configuration du service LoadBalancer. Avant de lire cette page, assurez-vous de maîtriser les concepts du service LoadBalancer de Google Kubernetes Engine (GKE).

Paramètres de l'objet Service

GKE est compatible avec les paramètres suivants pour les services LoadBalancer.

Paramètre Champ et description du service Interne Externe Compatibilité avec les versions
Équilibreur de charge réseau passthrough interne
  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal
  • networking.gke.io/load-balancer-type: "Internal"

Indique à GKE de créer un équilibreur de charge réseau passthrough interne.

L'équilibreur de charge utilise des backends NEG GCE_VM_IP si l'une des conditions suivantes est remplie :

  • Le fichier manifeste du service est appliqué à un cluster sur lequel le sous-paramètre GKE est activé.
  • Le fichier manifeste du service est appliqué à un cluster qui exécute GKE version 1.36 ou ultérieure. Le sous-paramètre GKE est automatiquement activé dans GKE 1.36 et versions ultérieures.

Dans toutes les autres situations, l'équilibreur de charge utilise des backends de groupe d'instances. Pour en savoir plus, consultez la section Regroupement de nœuds.

  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal : nécessite GKE version 1.33.1-gke.1779000 et ultérieures et l'activation du sous-paramètre GKE.
  • networking.gke.io/load-balancer-type: "Internal" : toutes les versions compatibles.

Nous vous recommandons d'utiliser spec.loadBalancerClass si votre cluster utilise GKE 1.33.1-gke.1779000 ou une version ultérieure, et si le sous-paramétrage GKE est activé. Cet attribut est immuable et ne peut pas être modifié une fois que le fichier manifeste du service a été appliqué à un cluster.

Équilibreur de charge réseau passthrough externe régional basé sur un service de backend
  • Comportement par défaut dans GKE 1.37 et versions ultérieures
  • spec.loadBalancerClass: networking.gke.io/l4-regional-external
  • cloud.google.com/l4-rbs: "enabled"

Indique à GKE de créer un équilibreur de charge réseau passthrough externe régional.

L'équilibreur de charge utilise des backends NEG GCE_VM_IP si l'une des conditions suivantes est remplie :

  • Le service est créé dans un cluster qui exécute GKE version 1.37 ou ultérieure. Aucune annotation ni classe n'est requise.
  • Le fichier manifeste du service inclut spec.loadBalancerClass: networking.gke.io/l4-regional-external et est appliqué à un cluster qui exécute GKE version 1.33.1-gke.1779000 à 1.36.
  • Le fichier manifeste du service inclut l'annotation cloud.google.com/l4-rbs: "enabled" et est appliqué à un cluster qui exécute GKE version 1.32.2-gke.1652000 à 1.36.

Dans toutes les autres situations, l'équilibreur de charge utilise des backends de groupe d'instances. Pour en savoir plus, consultez la section Regroupement de nœuds.

  • spec.loadBalancerClass: networking.gke.io/l4-regional-external : nécessite GKE version 1.33.1-gke.1779000 ou ultérieure.
  • cloud.google.com/l4-rbs: "enabled" : toutes les versions compatibles.

Nous vous recommandons d'utiliser spec.loadBalancerClass si votre cluster utilise GKE version 1.33.1-gke.1779000 à 1.36. Cet attribut est immuable et ne peut pas être modifié une fois que le fichier manifeste du service a été appliqué à un cluster. Dans GKE 1.37 et versions ultérieures, aucun champ n'est requis pour ce type d'équilibreur de charge.

Équilibrage de charge pondéré networking.gke.io/weighted-load-balancing: "pods-per-node"

Permet aux nœuds qui ont plus de pods de diffusion de recevoir une plus grande proportion de nouvelles connexions que les nœuds qui ont moins de pods de diffusion.

GKE 1.31.0+
Règle de trafic interne spec.internalTrafficPolicy

Lorsque ce paramètre est défini sur la valeur Local, GKE n'achemine que les paquets des pods clients d'un nœud vers les pods de diffusion du même nœud. Lorsque ce paramètre est défini sur la valeur Cluster, GKE achemine les paquets des pods clients d'un nœud vers les pods de diffusion sur n'importe quel nœud. Pour en savoir plus, consultez la page Règle de trafic interne de service.

Ce paramètre n'est pas compatible avec les clusters exécutant GKE Dataplane V2.

GKE 1.22+
Règle de trafic externe spec.externalTrafficPolicy

Contrôle les VM de nœud qui réussissent les vérifications d'état de l'équilibreur de charge et la manière dont les paquets sont acheminés vers les pods prêts et actifs du cluster. Contrôle également la manière dont les nœuds sont regroupés dans les NEG GCE_VM_IP lorsque le sous-paramètre GKE est activé.

Pour en savoir plus, consultez la page Concepts du service LoadBalancer.

GKE 1.14+ (1.23.4-gke.400+ pour le pool de nœuds Windows)
Affinité zonale spec.trafficDistribution: PreferSameZone

Active l'affinité zonale pour les services LoadBalancer internes. L'affinité zonale contrôle la zone vers laquelle l'équilibreur de charge réseau passthrough interne achemine le trafic entrant pour les clients compatibles lorsqu'une correspondance zonale est possible. Pour utiliser l'affinité zonale, vous devez activer le sous-paramètre GKE (activé par défaut à partir de GKE version 1.36).

Pour en savoir plus, consultez Affinité zonale et distribution du trafic.

En version preview dans GKE 1.33.3-gke.1392000 et versions ultérieures. Disponibilité générale dans GKE version 1.36 et ultérieure.
Port de la vérification de l'état spec.healthCheckNodePort

Déploie une vérification de l'état de l'équilibreur de charge pour les services LoadBalancer. Ce paramètre n'est valide que si spec.externalTrafficPolicy est défini sur Local.

Toutes les versions compatibles.
Règles de pare-feu et liste d'autorisation d'adresses IP sources spec.loadBalancerSourceRanges

Configure des règles de pare-feu facultatives dans GKE et dans le réseau VPC pour n'autoriser que certaines plages sources. kube-proxy configure également les règles iptables pour qu'elles correspondent aux plages sources spécifiées.

Toutes les versions prises en charge.
Adresses IP statiques
  • spec.loadBalancerIP (IPv4 uniquement)
  • networking.gke.io/load-balancer-ip-addresses

Spécifie une adresse IPv4 statique, une plage d'adresses IPv6 statique ou les deux, attribuées aux règles de transfert de l'équilibreur de charge. Pour connaître les exigences de configuration et les informations d'implémentation importantes, consultez la section Éléments à prendre en compte dans le partage d'une adresse IP commune.

  • spec.loadBalancerIP : Toutes les versions compatibles
  • networking.gke.io/load-balancer-ip-addresses : GKE 1.29 et versions ultérieures Consultez la section Paramètres d'adresse IP statique pour obtenir des informations supplémentaires sur les exigences de configuration ou d'annotations du cluster.
Niveaux de service réseau cloud.google.com/network-tier

Spécifie les niveaux de service réseau utilisés par GKE pour la règle de transfert externe et l'adresse IP. Les valeurs d'annotation valides sont Standard et Premium (par défaut).

GKE 1.19 et versions ultérieures.
Sous-réseau personnalisé networking.gke.io/load-balancer-subnet
(s'applique uniquement à IPv6)
GKE 1.29 et versions ultérieures. Pour connaître les exigences supplémentaires, consultez Annotation de sous-réseau personnalisé.
Utiliser vos propres adresses IPv6 (BYOIPv6) networking.gke.io/ip-collection-v6: "projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME"

Spécifie un sous-préfixe IPv6 régional d'un préfixe délégué public (PDP) en mode EXTERNAL_IPV6_FORWARDING_RULE_CREATION. À partir de ce sous-préfixe, GKE alloue une plage d'adresses IPv6 /96 externe éphémère pour un service LoadBalancer externe IPv6 à pile unique. Vous pouvez spécifier le sous-préfixe en tant qu'URL de ressource complète ou en tant que chemin d'accès partiel à la ressource, comme indiqué dans l'exemple. Si vous modifiez cette annotation, GKE recrée la règle de transfert IPv6 avec une nouvelle adresse du nouveau préfixe. Si vous supprimez l'annotation, le service revient à une adresse fournie par Google à partir d'un sous-réseau avec une plage d'adresses IPv6 externe. Si le sous-réseau du cluster possède une plage d'adresses IPv6 interne, ajoutez l'annotation networking.gke.io/load-balancer-subnet en même temps.

Pour les services LoadBalancer internes, configurez BYOIPv6 en spécifiant un sous-réseau interne BYOIPv6 avec l'annotation networking.gke.io/load-balancer-subnet.


(s'applique uniquement à IPv6 à pile unique)
GKE version 1.37.1-gke.2097000 et versions ultérieures
Accès mondial networking.gke.io/internal-load-balancer-allow-global-access: "true"

Rend l'adresse IP de la règle de transfert accessible aux clients de n'importe quelle région du réseau VPC ou d'un réseau connecté.

Aperçu dans GKE 1.16+ Disponible pour tous les utilisateurs de GKE 1.17.9-gke.600 et versions ultérieures.
Tous les ports

GKE configure automatiquement la règle de transfert de façon à utiliser tous les ports si plus de cinq ports uniques (jusqu'à 100) sont spécifiés dans spec.ports[].port.

GKE version 1.18.19-gke.1400 ou ultérieure
ipFamilyPolicy

spec.ipFamilyPolicy

Définit la façon dont GKE alloue les adresses IP à un service. Vous pouvez définir spec.ipFamilyPolicy sur SingleStack, PreferDualStack ou RequireDualStack.

Pour créer un service LoadBalancer IPv6 à pile unique dans un cluster à double pile, définissez la valeur de ce champ sur SingleStack et celle du champ spec.ipFamilies sur IPv6. Dans un cluster IPv6 uniquement, il s'agit des valeurs par défaut et vous pouvez les omettre. Pour en savoir plus, consultez Services LoadBalancer IPv6.

Les clusters GKE version 1.29 ou ultérieure sont compatibles avec le réseau double pile pour les services LoadBalancer.

Les services LoadBalancer IPv6 à pile unique sont disponibles en version preview dans GKE 1.36.0-gke.2646000 et versions ultérieures.
ipFamilies (facultatif)

spec.ipFamilies

Définit la famille d'adresses IP à laquelle allouer des services à pile unique ou à double pile. Utilisez l'une des valeurs suivantes :

  • IPv4 pour le service IPv4 à pile unique seulement.
  • IPv6 pour le service IPv6 seulement.
  • IPv4,IPv6 pour le service à double pile, où l'adresse IP principale du service est IPv4.
  • IPv6,IPv4 pour le service à double pile, où l'adresse IP principale du service est IPv6.

Pour un service LoadBalancer IPv6 à pile unique dans un cluster à double pile, définissez la valeur de ce champ sur IPv6 et définissez la valeur du champ spec.ipFamilyPolicy sur SingleStack. Dans un cluster IPv6 uniquement, il s'agit des valeurs par défaut et vous pouvez les omettre. Pour en savoir plus, consultez Services LoadBalancer IPv6.

Les clusters GKE version 1.29 ou ultérieure sont compatibles avec le réseau double pile pour les services LoadBalancer.

Preview dans GKE version 1.36.0-gke.2646000 et versions ultérieures pour les services LoadBalancer IPv6 à pile unique.

Port de la vérification de l'état

Comme décrit dans la section Vérifications de l'état de l'équilibreur de charge, GKE déploie toujours une vérification de l'état de l'état de l'équilibreur de charge lorsqu'il crée un équilibreur de charge réseau passthrough externe régional ou un équilibreur de charge réseau passthrough interne.

Le fait de pouvoir définir ou non le paramètre healthCheckNodePort dépend de la configuration externalTrafficPolicy suivante :

externalTrafficPolicy Port de la vérification de l'état
Cluster

Vous ne pouvez pas utiliser spec.healthCheckNodePort.

Local

Vous pouvez sélectionner un port personnalisé à l'aide de spec.healthCheckNodePort. Si aucune valeur n'est spécifiée, le plan de contrôle Kubernetes attribue un port de vérification de l'état à partir de la plage de ports du nœud.

Règles de pare-feu et liste d'autorisation d'adresses IP sources

Sauf si vous avez configuré un cluster pour ignorer la création de règles de pare-feu VPC pour les services LoadBalancer, GKE crée une règle de pare-feu VPC d'autorisation d'entrée pour chaque service.

Chaque règle de pare-feu créée automatiquement présente les caractéristiques suivantes :

  • Le sens de la règle de pare-feu est une règle d'entrée, et son action est autorisée. Les règles de pare-feu implicites interdisant les entrées dans Google Cloudsignifient que GKE utilise un modèle de liste d'autorisation lors de la création de règles de pare-feu d'entrée.
  • GKE définit le protocole et le port de destination de la règle de pare-feu sur ceux spécifiés dans la liste spec.ports[] du service.
  • GKE configure les règles de pare-feu pour les services LoadBalancer en définissant explicitement le paramètre de destination sur l'adresse IP virtuelle de l'équilibreur de charge (la règle de transfert de l'équilibreur de charge).
  • GKE définit le paramètre cible de la règle de pare-feu de sorte qu'il inclue tous les nœuds du cluster.
  • Si le service inclut spec.loadBalancerSourceRanges[], GKE définit le paramètre source de la règle de pare-feu sur les adresses IP de cette liste. De plus, GKE configure des routes et des règles dans le système d'exploitation du nœud pour limiter les adresses IP sources du trafic à équilibrage de charge, à l'aide de kube-proxy et iptables (sur les clusters qui n'utilisent pas GKE Dataplane V2) ou de cilium-agent et de règles eBPF (sur les clusters avec GKE Dataplane V2). Si le service n'inclut pas loadBalancerSourceRanges[], GKE définit le paramètre source de la règle de pare-feu sur toutes les adresses IP (0.0.0.0/0).
  • Pour un service LoadBalancer IPv6, spécifiez des plages CIDR IPv6 dans le champ spec.loadBalancerSourceRanges[] (par exemple, la plage 2001:db8::/32). GKE crée une règle de pare-feu distincte pour la règle de transfert IPv6 du service. Si le service n'inclut pas le champ loadBalancerSourceRanges[], GKE définit le paramètre source de cette règle de pare-feu sur toutes les adresses IPv6 (::/0).

Adresses IP statiques

Vous pouvez créer une adresse IP statique et configurer GKE pour l'attribuer à la règle de transfert de l'équilibreur de charge. L'utilisation d'une adresse IP statique permet de s'assurer que l'adresse IP de l'équilibreur de charge reste la même, même si vous apportez des modifications au service LoadBalancer. Sans adresse IP statique, GKE peut attribuer une adresse IP différente à la règle de transfert de l'équilibreur de charge lorsque vous mettez à jour un service LoadBalancer. L'adresse IP de la règle de transfert n'est pas identique à l'adresse IP du service spec.clusterIP. L'adresse ClusterIP d'un service ne change jamais lorsque vous mettez à jour un service LoadBalancer.

Paramètres d'adresse IP statique

Pour indiquer à un service LoadBalancer d'utiliser une adresse IP statique, utilisez le paramètre spec.loadBalancerIP ou l'annotation networking.gke.io/load-balancer-ip-addresses. Dans GKE 1.29 et versions ultérieures, l'annotation est prioritaire sur spec.loadBalancerIP si le fichier manifeste du service contient à la fois le paramètre et l'annotation.

Paramètre ou annotation et valeur Conditions requises et fonctionnalités
spec.loadBalancerIP:
IPv4_ADDRESS

Vous pouvez spécifier une adresse IPv4 interne statique pour un service LoadBalancer interne IPv4 uniquement. Vous pouvez spécifier une adresse IPv4 externe statique pour un service LoadBalancer externe IPv4 uniquement. Le paramètre fonctionne avec toutes les versions de GKE compatibles.

networking.gke.io/load-balancer-ip-addresses:
IP_ADDRESS_RESOURCE_NAME
  • Pour les services LoadBalancer à pile unique, définissez la valeur de l'annotation sur le nom de la ressource d'adresse IPv4 ou IPv6, et non sur l'adresse IP elle-même.
  • Pour les services LoadBalancer à double pile, définissez la valeur de l'annotation sur le nom de ressource de l'adresse IPv4 statique et sur le nom de la ressource de la plage d'adresses IPv6 statique, séparés par une virgule.

Vous pouvez spécifier une adresse IPv4 statique, une plage d'adresses IPv6 statique ou les deux pour les services LoadBalancer internes et externes à double pile, IPv4 uniquement et IPv6 uniquement. L'annotation nécessite GKE 1.29 ou une version ultérieure, ainsi que les exigences supplémentaires suivantes:

  • Pour utiliser cette annotation avec un service LoadBalancer interne, le sous-paramètre GKE doit être activé sur votre cluster. Le sous-paramètre GKE est activé par défaut dans GKE 1.36 et versions ultérieures.
  • Pour utiliser cette annotation avec un service LoadBalancer externe, vous devez définir le champ spec.loadBalancerClass sur la valeur networking.gke.io/l4-regional-external dans le fichier manifeste du service lorsque vous créez le service LoadBalancer externe.
  • Pour un service LoadBalancer externe IPv6 à pile unique dans GKE version 1.37.1-gke.2097000 et ultérieure, vous pouvez également réserver la plage d'adresses IPv6 statiques à partir d'un préfixe délégué public BYOIPv6 régional en mode EXTERNAL_IPV6_FORWARDING_RULE_CREATION.
  • Pour un service LoadBalancer interne, vous pouvez réserver la plage d'adresses IPv6 statiques à partir d'un sous-réseau interne provisionné à partir d'un préfixe délégué public BYOIPv6 en mode INTERNAL_IPV6_SUBNETWORK_CREATION.

Éléments à prendre en compte pour le partage d'une adresse IP commune

Deux services LoadBalancer ou plus peuvent faire référence à la même adresse IP statique si la règle de transfert de chaque équilibreur de charge utilise une combinaison unique d'adresse IP, de protocole, de spécification de port et de spécification de niveaux de service réseau, comme indiqué dans le tableau de cette section. De plus :

  • Les adresses IPv6 statiques sont en fait des plages d'adresses IPv6 /96, mais GKE configure les nœuds pour qu'ils acceptent les paquets sur la première adresse IPv6 (/128) de la plage /96.

  • Pour qu'au moins deux services LoadBalancer internes utilisent la même adresse IPv4 interne, l'adresse IP statique doit être créée avec l'objectif SHARED_LOADBALANCER_VIP.

Service LoadBalancer interne Service LoadBalancer externe
Spécification du port

Les règles de transfert des équilibreurs de charge réseau passthrough internes acceptent jusqu'à cinq numéros de port distincts, ou peuvent être configurées pour utiliser tous les ports.

Lorsqu'un service LoadBalancer interne dispose de plus de cinq spec.ports[] spécifiés, GKE configure la règle de transfert pour que l'équilibreur de charge réseau passthrough interne utilise tous les ports.

Les règles de transfert avec la même adresse IP et le même protocole ne peuvent pas comporter de ports qui se chevauchent. Cela signifie que vous ne pouvez pas créer plusieurs services LoadBalancer internes partageant les mêmes adresse IP, protocole et port(s). Exemple :

  • Si vous créez un service LoadBalancer interne utilisant le port TCP 80, vous ne pouvez pas créer un autre service utilisant les ports TCP 80, 81 et 90, car le port 80 se chevauche.
  • Si un service LoadBalancer interne utilise les ports TCP 80, 8080 et 90, vous ne pouvez pas créer un autre service utilisant TCP sur tous les ports, car cela entraînerait également un chevauchement des ports.

Pour en savoir plus, consultez Règles de transfert de l'équilibreur de charge réseau passthrough interne utilisant une adresse IP commune.

Pour les clusters exécutant des versions de GKE antérieures à la version 1.37, GKE crée un équilibreur de charge réseau passthrough externe régional basé sur un pool cible si le champ spec.loadBalancerClass du fichier manifeste du service LoadBalancer n'est pas défini sur la valeur networking.gke.io/l4-regional-external ou s'il n'inclut pas l'annotation cloud.google.com/l4-rbs: "enabled". Pour les clusters exécutant GKE 1.37 ou une version ultérieure, vous devez définir explicitement spec.loadBalancerClass: "networking.gke.io/l4-regional-external-legacy" pour créer un équilibreur de charge réseau passthrough externe régional basé sur un pool cible.

Les règles de transfert des équilibreurs de charge réseau passthrough externes régionaux basés sur un pool cible doivent utiliser des plages de ports contiguës. La plage de ports contigus inclut tous les ports dont le service a besoin, mais elle peut également inclure des ports supplémentaires non utilisés par le service. Par exemple, un service LoadBalancer externe fourni par un équilibreur de charge réseau passthrough externe régional basé sur un pool cible, qui spécifie les ports 80 et 443 dans son fichier manifeste de service, utilise une règle de transfert d'équilibreur de charge avec une plage de ports de 80 à 443. Cette plage de ports empêche d'autres services LoadBalancer externes d'utiliser les ports 80 et 443, ainsi que les numéros compris entre 80 et 443.

GKE crée par défaut un équilibreur de charge réseau passthrough externe régional basé sur un service de backend dans les versions 1.37 ou ultérieures. Dans les versions antérieures, GKE crée l'équilibreur de charge si le fichier manifeste du service LoadBalancer inclut le champ spec.loadBalancerClass défini sur la valeur networking.gke.io/l4-regional-external. Les règles de transfert des équilibreurs de charge réseau passthrough externes régionaux basés sur un service de backend acceptent jusqu'à cinq numéros de port distincts ou une plage de ports contiguë.

Niveaux de service réseau Non configurable : les adresses internes sont toujours associées au niveau Premium.

Configurable pour les adresses IPv4 externes régionales statiques. Les plages d'adresses IPv6 externes statiques régionales ne peuvent être créées qu'avec le niveau Premium.

La spécification des niveaux de service réseau de l'adresse IP externe statique doit correspondre à l'un des éléments suivants:

  • Le niveau spécifié dans l'annotation cloud.google.com/network-tier du fichier manifeste du service LoadBalancer, si cette annotation est présente dans le fichier manifeste, ou
  • Niveau par défaut du projet, si l'annotation cloud.google.com/network-tier est absente du fichier manifeste du service LoadBalancer.

Le niveau par défaut du projet est Premium, sauf si vous l'avez configuré différemment.

Réservation d'adresses IP

GKE ne réserve pas les adresses IP statiques configurées à l'aide de l'annotation spec.loadBalancerIP ou networking.gke.io/load-balancer-ip-addresses. Cela signifie que l'adresse IP que vous attribuez à votre service peut être libérée lorsque le service est supprimé.

Pour conserver l'adresse IP réservée, vous devez créer manuellement une ressource d'adresse dans votre projet. L'adresse IP statique doit présenter les attributs suivants :

  • Être uniquement régionaux.
  • Se trouver dans la même région que le cluster.
  • Se trouver dans le même Niveau de service réseau que le service LoadBalancer.
  • Avoir un nom qui n'utilise pas le nom de l'équilibreur de charge, des préfixes tels que k8s- ou l'UUID du service.

Si vous ne réservez pas l'adresse vous-même, les journaux du projet peuvent contenir des entrées concernant des ressources d'adresse créées et supprimées peu de temps après. Cela fait partie du provisionnement normal du service et est attendu.

Sous-réseau d'équilibreur de charge

Vous pouvez configurer un service LoadBalancer interne pour utiliser une adresse IPv4 éphémère ou statique, une plage d'adresses IPv6 ou les deux, dans un sous-réseau personnalisé situé dans la même région et sur le même réseau VPC que le cluster. Utiliser un sous-réseau personnalisé pour un service LoadBalancer interne afin d'effectuer les opérations suivantes:

  • Regrouper les équilibreurs de charge réseau passthrough internes créés par des services LoadBalancer internes à partir de deux clusters GKE ou plus dans le même réseau VPC et la même région.
  • Créer des services LoadBalancer internes dont les équilibreurs de charge réseau passthrough internes ont des adresses IPv4 distinctes des adresses IPv4 des nœuds du cluster.
  • Créer des services LoadBalancer internes dont les équilibreurs de charge réseau passthrough internes disposent de plages d'adresses IPv6 distinctes des adresses IPv6 de nœud et de pod du cluster. Un sous-réseau LoadBalancer personnalisé est obligatoire pour prendre en charge les services LoadBalancer internes si le sous-réseau du cluster possède une plage d'adresses IPv6 externe.

Vous pouvez configurer un service LoadBalancer externe pour utiliser une plage d'adresses IPv6 éphémère ou statique dans un sous-réseau personnalisé situé dans la même région et sur le même réseau VPC que le cluster. Utilisez un sous-réseau personnalisé pour créer des services LoadBalancer externes dont les équilibreurs de charge réseau passthrough externes régionaux disposent de plages d'adresses IPv6 distinctes des adresses IPv6 de nœud et de pod du cluster. Un sous-réseau LoadBalancer personnalisé est obligatoire pour prendre en charge les services LoadBalancer externes si le sous-réseau du cluster possède une plage d'adresses IPv6 internes.

Les adresses IPv6 des équilibreurs de charge réseau passthrough internes et des équilibreurs de charge réseau passthrough externes régionaux proviennent généralement d'une plage de sous-réseaux de votre réseau VPC. Pour les services LoadBalancer externes IPv6 à pile unique dans GKE version 1.37.1-gke.2097000 et ultérieures, les adresses IPv6 peuvent provenir d'un préfixe délégué public BYOIPv6. Lorsque l'adresse provient d'un sous-réseau, le type d'accès IPv6 de ce sous-réseau doit correspondre au type d'équilibreur de charge que vous créez : les services LoadBalancer internes nécessitent un sous-réseau avec une plage d'adresses IPv6 internes (y compris les sous-réseaux provisionnés à partir d'un préfixe BYOIPv6), et les services LoadBalancer externes nécessitent un sous-réseau avec une plage d'adresses IPv6 externes. Pour savoir quand un sous-réseau LoadBalancer personnalisé est requis, consultez Services LoadBalancer IPv6.

Annotation de sous-réseau personnalisé

Utilisez l'annotation networking.gke.io/load-balancer-subnet: SUBNET_RESOURCE_NAME pour indiquer à un service LoadBalancer d'utiliser une adresse IP éphémère ou une adresse IP statique dans un sous-réseau personnalisé, où SUBNET_RESOURCE_NAME est le nom du sous-réseau personnalisé. Vous pouvez utiliser cette annotation pour spécifier un sous-réseau personnalisé pour un service LoadBalancer interne à double pile, IPv4 uniquement ou IPv6 uniquement, ou pour un service LoadBalancer externe à double pile ou IPv6 uniquement.

Pour utiliser l'annotation networking.gke.io/load-balancer-subnet, vous devez remplir les conditions suivantes :

  • Votre cluster doit exécuter GKE 1.29 ou une version ultérieure.
  • Pour spécifier un sous-réseau personnalisé pour un service LoadBalancer interne, le sous-paramètre GKE doit être activé sur votre cluster. Le sous-paramètre GKE est activé par défaut dans les versions 1.36 et ultérieures.
  • Pour spécifier un sous-réseau personnalisé pour un service LoadBalancer externe, vous devez configurer un équilibreur de charge basé sur un service de backend. Dans GKE 1.37 et versions ultérieures, cette configuration est le comportement par défaut. Dans les versions antérieures, vous devez inclure le champ spec.loadBalancerClass défini sur la valeur networking.gke.io/l4-regional-external dans le fichier manifeste du service lorsque vous créez le service LoadBalancer externe.
  • Pour les clusters IPv6 à pile unique (créés avec l'option --stack-type=ipv6), vous devez utiliser cette annotation lorsque le type d'accès de l'équilibreur de charge diffère du type d'accès de votre sous-réseau de nœuds. Par exemple, utilisez cette annotation lorsque vous déployez un service LoadBalancer externe sur un cluster dont le sous-réseau de nœuds utilise le type d'accès IPv6 INTERNAL (ULA), ou lorsque vous déployez un service LoadBalancer interne sur un cluster dont le sous-réseau de nœuds utilise le type d'accès IPv6 EXTERNAL (GUA). Le sous-réseau spécifié par cette annotation doit avoir un type d'accès IPv6 (EXTERNAL ou INTERNAL) correspondant au type d'équilibreur de charge correspondant. Un service LoadBalancer externe peut également utiliser sa plage d'adresses IPv6 à partir d'un préfixe délégué public BYOIPv6 au lieu d'un sous-réseau. Dans ce cas, n'utilisez pas cette annotation.

Sous-réseau et adresse IPv4 pour un service LoadBalancer interne

Le tableau ci-dessous décrit les combinaisons de spécifications de sous-réseau et d'adresses IPv4 valides pour un service LoadBalancer interne à double pile ou IPv4 uniquement.

Adresse IPv4 statique Adresse IPv4 éphémère
Sous-réseau personnalisé
Sous-réseau personnalisé et adresse IPv4 statique: l'adresse IPv4 interne statique doit avoir été créée dans la plage d'adresses IPv4 principale du sous-réseau personnalisé. Sous-réseau personnalisé et adresse IPv4 éphémère: GKE utilise une adresse IPv4 interne non allouée dans la plage d'adresses IPv4 principale du sous-réseau personnalisé.
Sous-réseau de cluster Sous-réseau de cluster et adresse IPv4 statique: l'adresse IPv4 interne statique doit avoir été créée dans la plage d'adresses IPv4 principale du sous-réseau de cluster. Sous-réseau de cluster et adresse IPv4 éphémère: GKE utilise une adresse IPv4 interne non allouée dans la plage d'adresses IPv4 principale du sous-réseau de cluster.

Sous-réseau et plage d'adresses IPv6 pour un service LoadBalancer interne

Le tableau ci-dessous décrit les combinaisons de spécifications de sous-réseau et de plages d'adresses IPv6 valides pour un service LoadBalancer interne à double pile ou IPv6 uniquement. Même si la règle de transfert IPv6 de l'équilibreur de charge réseau interne passthrough utilise une plage d'adresses IPv6 interne /96, GKE ne configure les nœuds que pour accepter les paquets dont les destinations correspondent à la première adresse IPv6 (/128) de la plage /96 de la règle de transfert.

Plage d'adresses IPv6 statiques Plage d'adresses IPv6 éphémère
Sous-réseau à double pile ou IPv6 uniquement personnalisé
  • Doit se trouver dans le même réseau VPC et dans la même région que le cluster.
  • Doit disposer d'une plage d'adresses IPv6 interne (type d'accès INTERNAL), qui peut être une plage d'adresses IPv6 interne fournie par Google ou une plage d'adresses interne BYOIPv6 provisionnée à partir d'un préfixe délégué public en mode INTERNAL_IPV6_SUBNETWORK_CREATION.
  • Doit être spécifié à l'aide de l'annotation networking.gke.io/load-balancer-subnet.
Sous-réseau personnalisé et plage d'adresses IPv6 statique: la plage d'adresses IPv6 interne statique /96 doit avoir été créée dans la plage d'adresses IPv6 /64 internes du sous-réseau personnalisé. Sous-réseau personnalisé et plage d'adresses IPv6 éphémère : GKE utilise une plage d'adresses IPv6 interne /96 non allouée de la plage d'adresses IPv6 interne /64 du sous-réseau personnalisé.
Sous-réseau à double pile ou IPv6 uniquement du cluster
  • Doit disposer d'une plage d'adresses IPv6 interne (type d'accès INTERNAL), qui peut être une plage d'adresses IPv6 interne fournie par Google ou une plage d'adresses interne BYOIPv6.
Sous-réseau de cluster et plage d'adresses IPv6 statique: la plage d'adresses IPv6 interne statique /96 doit avoir été créée dans la plage d'adresses IPv6 /64 internes du sous-réseau de cluster. Sous-réseau de cluster et plage d'adresses IPv6 éphémère : GKE utilise une plage d'adresses IPv6 interne /96 non allouée de la plage d'adresses IPv6 /64 interne du sous-réseau de cluster.

Sous-réseau et adresse IPv4 pour un service LoadBalancer externe

Pour les services LoadBalancer externes IPv4 uniquement et à double pile, l'adresse IPv4 externe, qu'il s'agisse d'une adresse IPv4 externe statique ou d'une adresse IPv4 externe éphémère, ne provient pas d'un sous-réseau.

Sous-réseau et plage d'adresses IPv6 pour un service LoadBalancer externe

Le tableau suivant décrit les combinaisons valides de sous-réseau ou de sous-préfixe et de plage d'adresses IPv6 pour un service LoadBalancer externe IPv6 à pile unique ou à double pile. Même si la règle de transfert IPv6 de l'équilibreur de charge réseau passthrough externe régional utilise une plage d'adresses IPv6 /96 externe, GKE ne configure les nœuds que pour accepter les paquets dont les destinations correspondent à la première adresse IPv6 (/128) de la plage /96 de la règle de transfert.

Plage d'adresses IPv6 statiques Plage d'adresses IPv6 éphémère
Sous-réseau à double pile ou IPv6 uniquement personnalisé
  • Doit se trouver dans le même réseau VPC et dans la même région que le cluster.
  • Doit disposer d'une plage d'adresses IPv6 externe (type d'accès EXTERNAL).
  • Doit être spécifié à l'aide de l'annotation networking.gke.io/load-balancer-subnet.
Sous-réseau personnalisé et plage d'adresses IPv6 statiques: la plage d'adresses IPv6 externe statique /96 doit avoir été créée dans la plage d'adresses IPv6 externes /64 du sous-réseau personnalisé. Les plages d'adresses IPv6 externes statiques ne peuvent être créées qu'avec le niveau Premium. Sous-réseau personnalisé et plage d'adresses IPv6 éphémère : GKE utilise une plage d'adresses IPv6 externe /96 non allouée de la plage d'adresses IPv6 externe /64 du sous-réseau personnalisé.
Sous-réseau à double pile ou IPv6 uniquement du cluster
  • Doit disposer d'une plage d'adresses IPv6 externe (type d'accès EXTERNAL).
Sous-réseau de cluster et plage d'adresses IPv6 statique: la plage d'adresses IPv6 externe statique /96 doit avoir été créée dans la plage d'adresses IPv6 /64 externe du sous-réseau de cluster. Les plages d'adresses IPv6 externes statiques ne peuvent être créées qu'avec le niveau Premium. Sous-réseau de cluster et plage d'adresses IPv6 éphémère : GKE utilise une plage d'adresses IPv6 externe /96 non allouée, de la plage d'adresses IPv6 /64 externe du sous-réseau de cluster.
Préfixe délégué public BYOIPv6
  • S'applique uniquement aux services LoadBalancer externes IPv6 à pile unique dans GKE version 1.37.1-gke.2097000 et ultérieure.
  • Le sous-préfixe régional doit se trouver dans la même région que le cluster, utiliser le mode EXTERNAL_IPV6_FORWARDING_RULE_CREATION et avoir une longueur de préfixe attribuable de /96.
  • Le sous-préfixe doit être à l'état ANNOUNCED.
  • Fonctionne sur les clusters IPv6 à pile unique et sur les clusters à double pile (le service lui-même doit être IPv6 à pile unique). Le sous-réseau du cluster peut avoir une plage d'adresses IPv6 internes ou externes (type d'accès INTERNAL ou EXTERNAL). Aucun sous-réseau IPv6 externe n'est requis, car la plage d'adresses provient du sous-préfixe.
  • Nécessite un équilibreur de charge réseau passthrough externe régional basé sur un service de backend (spec.loadBalancerClass: networking.gke.io/l4-regional-external) au niveau Premium.
Préfixe BYOIPv6 et plage d'adresses IPv6 statiques : vous devez réserver la plage d'adresses IPv6 externes statiques /96 à partir du sous-préfixe régional à l'aide des options --endpoint-type=NETLB et --ip-collection, et référencer l'adresse statique à l'aide de l'annotation networking.gke.io/load-balancer-ip-addresses. Vous pouvez également inclure l'annotation networking.gke.io/ip-collection-v6. Dans ce cas, cette annotation doit faire référence au même sous-préfixe que celui à partir duquel vous avez réservé l'adresse statique. Préfixe BYOIPv6 et plage d'adresses IPv6 éphémère : spécifiez le sous-préfixe régional à l'aide de l'annotation networking.gke.io/ip-collection-v6. GKE alloue une plage d'adresses IPv6 /96 externe disponible à partir du sous-préfixe.

Accès mondial

Lorsque l'annotation networking.gke.io/internal-load-balancer-allow-global-access est définie sur false ou non spécifiée pour un service LoadBalancer interne, GKE crée un équilibreur de charge réseau passthrough interne dont l'accès mondial est désactivé pour la règle de transfert. Lorsque l'accès mondial est désactivé, les clients devant accéder à l'équilibreur de charge doivent se trouver dans la même région et sur le même réseau VPC, ou bien un réseau connecté au réseau VPC du cluster.

Lorsque l'annotation networking.gke.io/internal-load-balancer-allow-global-access est définie sur true pour un service LoadBalancer interne, GKE active l'option d'accès mondial sur la règle de transfert de l'équilibreur de charge réseau passthrough interne. Les clients situés dans n'importe quelle région du réseau VPC ou sur un réseau connecté au réseau VPC du cluster peuvent accéder à l'équilibreur de charge.

Pour en savoir plus sur l'accès mondial qui s'applique aux clients d'un réseau connecté, consultez les pages suivantes :

Toutes les règles de transfert de ports

Les règles de transfert des équilibreurs de charge réseau passthrough internes acceptent cinq numéros de port uniques ou bien l'ensemble des ports.

Dans GKE, un service LoadBalancer interne ne peut accepter que 100 ports dans le spec.ports[].port du service. Si un service LoadBalancer interne définit jusqu'à cinq ports, la règle de transfert inclura ces ports spécifiques. Toutefois, si le service spécifie plus de cinq ports, la règle de transfert sera automatiquement configurée pour correspondre à tous les ports. Lors de la configuration d'une règle de transfert pour utiliser tous les ports, GKE ne crée des règles de pare-feu d'autorisation d'entrée que pour les ports spécifiques configurés dans spec.ports[].port sur le service.

Pour en savoir plus sur les règles de transfert de l'équilibreur de charge réseau passthrough interne et les spécifications de port valides, consultez la page Règles de transfert et spécifications de ports.

Service LoadBalancer à double pile IPv4/IPv6

Vous pouvez créer un service LoadBalancer interne ou externe qui peut être à pile unique (IPv4 seulement ou IPv6 uniquement) ou à double pile. Les services LoadBalancer à pile unique créent une règle de transfert unique avec une adresse IPv4 ou avec une adresse IPv6. Les services LoadBalancer à double pile créent deux règles de transfert : l'une avec une adresse IPv4 et l'autre avec une adresse IPv6. Pour créer un service LoadBalancer à double pile IPv4/IPv6, déployez-le sur un cluster à double pile IPv4/IPv6 et effectuez l'une des opérations suivantes, selon le type d'équilibreur de charge que vous utilisez :

Pour chaque service, vous pouvez définir les spécifications ipFamilyPolicy et ipFamilies. Pour en savoir plus, consultez la page IPv4/IPv6 à double pile.

Restrictions applicables aux services LoadBalancer à double pile

  • Les services LoadBalancer avec des adresses IPv6 ne sont pas compatibles avec les clusters avec pile de type ipv4. Pour en savoir plus, consultez Utiliser une adresse IP à double pile pour un cluster de VPC natif ou Configurer un cluster IPv6 à pile unique.
  • Les services LoadBalancer créés avec une adresse à simple pile ne peuvent pas être mis à niveau vers des services à double pile.

  • Les services LoadBalancer créés avec des adresses à double pile peuvent passer en mode à pile unique conformément aux conditions suivantes :

    • Un service avec ipFamilies ["IPv4","IPv6"] peut devenir un service avec ipFamilies IPv4, mais pas IPv6.
    • Un service avec ipFamilies ["IPv6","IPv4"] peut devenir un service avec ipFamilies IPv6, mais pas IPv4.

Services LoadBalancer IPv6

Un service LoadBalancer IPv6 est un service LoadBalancer dont la règle de transfert possède une adresse IPv6. Un service peut être à pile unique IPv6 ou à double pile avec une règle de transfert IPv4 et une règle de transfert IPv6. Pour créer un service LoadBalancer IPv6 à pile unique dans un cluster à double pile, définissez la valeur du champ spec.ipFamilyPolicy sur SingleStack et celle du champ spec.ipFamilies sur IPv6. Dans un cluster IPv6 uniquement, il s'agit des valeurs par défaut et vous pouvez les omettre.

Les services LoadBalancer IPv6 utilisent toujours des backends de NEG GCE_VM_IP, et leurs adresses IPv6 proviennent d'une plage de sous-réseau de votre réseau VPC ou d'un préfixe délégué public BYOIPv6 (Bring Your Own IPv6).

Les services LoadBalancer IPv6 à pile unique sont disponibles en version preview dans GKE 1.36.0-gke.2646000 et versions ultérieures.

Restrictions applicables aux services LoadBalancer IPv6

  • Vous ne pouvez pas utiliser le champ spec.loadBalancerIP pour spécifier une adresse IPv6. Utilisez plutôt l'annotation networking.gke.io/load-balancer-ip-addresses.
  • Les services LoadBalancer IPv6 externes, y compris les plages d'adresses IPv6 externes statiques, ne sont compatibles qu'avec le niveau Premium. GKE rejette les services LoadBalancer IPv6 externes qui définissent l'annotation cloud.google.com/network-tier: Standard.
  • Vous ne pouvez pas modifier un service LoadBalancer IPv6 à pile unique pour utiliser une adresse IPv4. La définition de la valeur du champ spec.ipFamilies sur IPv4 ou de la valeur du champ spec.ipFamilyPolicy sur RequireDualStack est rejetée.
  • Vous ne pouvez utiliser l'annotation networking.gke.io/ip-collection-v6 que sur les services LoadBalancer externes IPv6 à pile unique dans GKE version 1.37.1-gke.2097000 et ultérieures. GKE n'est pas compatible avec l'annotation networking.gke.io/ip-collection-v6 pour les services à double pile, les services IPv4 ou les services LoadBalancer internes. Vous ne pouvez pas combiner cette annotation avec l'annotation networking.gke.io/load-balancer-subnet.

Choisir un sous-réseau pour l'équilibreur de charge

Le type d'accès IPv6 du sous-réseau qui fournit l'adresse IP de l'équilibreur de charge doit correspondre au type d'équilibreur de charge. Si le sous-réseau du cluster dispose déjà du type d'accès requis, GKE utilise le sous-réseau du cluster. Sinon, vous devez créer un sous-réseau LoadBalancer personnalisé avec le type d'accès requis et spécifier ce sous-réseau avec l'annotation networking.gke.io/load-balancer-subnet. La seule exception est un service LoadBalancer externe qui utilise un préfixe délégué public BYOIPv6, car ce préfixe fournit la plage d'adresses IPv6 quel que soit le type d'accès du sous-réseau du cluster.

Le tableau suivant récapitule le sous-réseau ou le préfixe qui fournit la plage d'adresses IPv6 de l'équilibreur de charge :

Type de service LoadBalancer Type d'accès IPv6 du sous-réseau du cluster Source de la plage d'adresses IPv6 de l'équilibreur de charge
Interne INTERNAL Le sous-réseau du cluster. Aucune annotation n'est requise.
Interne EXTERNAL Un sous-réseau LoadBalancer personnalisé avec un type d'accès IPv6 INTERNAL, spécifié avec l'annotation networking.gke.io/load-balancer-subnet.
Interne avec BYOIPv6 INTERNAL ou EXTERNAL Un sous-réseau dont la plage d'adresses IPv6 internes provient d'un préfixe délégué public BYOIPv6 en mode INTERNAL_IPV6_SUBNETWORK_CREATION, spécifié avec l'annotation networking.gke.io/load-balancer-subnet (aucune annotation n'est requise si ce sous-réseau est le sous-réseau du cluster).
Externe EXTERNAL Le sous-réseau du cluster. Aucune annotation n'est requise.
Externe INTERNAL Un sous-réseau LoadBalancer personnalisé avec un type d'accès IPv6 EXTERNAL, spécifié avec l'annotation networking.gke.io/load-balancer-subnet.
Externe avec BYOIPv6
(GKE 1.37.1-gke.2097000 et versions ultérieures)
INTERNAL ou EXTERNAL Un préfixe délégué public BYOIPv6 en mode EXTERNAL_IPV6_FORWARDING_RULE_CREATION, spécifié avec l'annotation networking.gke.io/ip-collection-v6 ou par une adresse IPv6 statique réservée à partir du préfixe. Ne spécifiez pas l'annotation networking.gke.io/load-balancer-subnet.

Pour connaître les combinaisons valides de sous-réseau et de plage d'adresses IPv6, consultez Sous-réseau et plage d'adresses IPv6 pour un service LoadBalancer interne et Sous-réseau et plage d'adresses IPv6 pour un service LoadBalancer externe.

Utiliser vos propres adresses IPv6 (BYOIPv6)

Vous pouvez utiliser vos propres adresses IPv6 (BYOIPv6) avec les services LoadBalancer IPv6 internes et externes.

Pour les services LoadBalancer externes, qui allouent des adresses directement à partir d'un préfixe délégué public, l'agent de service GKE (service-PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com) nécessite des autorisations IAM (Identity and Access Management) spécifiques. Attribuez le rôle d'administrateur d'adresses IP publiques Compute (roles/compute.publicIpAdmin) à cet agent sur le projet qui possède le préfixe délégué public. Ce rôle inclut l'autorisation compute.publicDelegatedPrefixes.use.

GKE nécessite cette autorisation lors de la création initiale du service et à chaque synchronisation du service.

Services LoadBalancer externes (GKE version 1.37.1-gke.2097000 et ultérieures) : les services LoadBalancer externes IPv6 à pile unique (spec.ipFamilyPolicy: SingleStack et spec.ipFamilies: ["IPv6"]) allouent des plages d'adresses BYOIPv6 externes /96 directement à partir d'un sous-préfixe IPv6 régional d'un préfixe délégué public (PDP). GKE est compatible avec cette fonctionnalité sur les clusters IPv6 à pile unique et les clusters à double pile, à condition que le service soit IPv6 à pile unique. Le sous-réseau du cluster peut avoir un type d'accès IPv6 interne ou externe, car la plage d'adresses provient du sous-préfixe plutôt que d'un sous-réseau.

Le sous-préfixe IPv6 régional doit répondre aux exigences suivantes :

  • Configuré avec le mode EXTERNAL_IPV6_FORWARDING_RULE_CREATION
  • Configuré avec une longueur de préfixe attribuable de /96
  • État ANNOUNCED

Pour allouer une plage d'adresses BYOIPv6 externes éphémères, spécifiez le sous-préfixe dans l'annotation networking.gke.io/ip-collection-v6 (fournie sous la forme d'une URL de ressource complète ou du chemin d'accès partiel à la ressource projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME). Vous pouvez également utiliser une plage d'adresses BYOIPv6 externes statiques que vous avez réservée à partir du sous-préfixe, à l'aide de l'annotation networking.gke.io/load-balancer-ip-addresses.

Si vous modifiez l'annotation networking.gke.io/ip-collection-v6, GKE recrée la règle de transfert IPv6 avec une nouvelle adresse du nouveau préfixe, ce qui perturbe brièvement le trafic. Si vous supprimez l'annotation, le service revient à une adresse fournie par Google à partir d'un sous-réseau avec une plage d'adresses IPv6 externes. Si le sous-réseau de votre cluster utilise une plage d'adresses IPv6 internes, vous devez ajouter simultanément l'annotation networking.gke.io/load-balancer-subnet pour éviter les erreurs. Pour en savoir plus, consultez Utiliser vos propres adresses IPv6 (BYOIPv6) pour un service LoadBalancer externe.

Services LoadBalancer internes : les services LoadBalancer internes IPv6 utilisent des adresses BYOIPv6 d'un sous-réseau IPv6 interne. Vous créez ce sous-réseau à partir d'un sous-préfixe IPv6 régional d'un préfixe délégué public (PDP) configuré en mode INTERNAL_IPV6_SUBNETWORK_CREATION. Pour en savoir plus, consultez Créer et utiliser des sous-préfixes IPv6.

Pour configurer le service, spécifiez le sous-réseau BYOIPv6 à l'aide de l'annotation networking.gke.io/load-balancer-subnet ou utilisez ce sous-réseau comme sous-réseau par défaut du cluster. Vous pouvez éventuellement spécifier une adresse BYOIPv6 interne statique réservée à l'aide de l'annotation networking.gke.io/load-balancer-ip-addresses.

Les services LoadBalancer internes ne sont pas compatibles avec l'annotation networking.gke.io/ip-collection-v6. Si vous appliquez cette annotation, GKE l'ignore et émet un événement d'avertissement IPCollectionV6Error. Pour en savoir plus, consultez Utiliser vos propres adresses IPv6 (BYOIPv6) pour un service LoadBalancer interne.

Étapes suivantes