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 |
Indique à GKE de créer un équilibreur de charge réseau passthrough interne. L'équilibreur de charge utilise des backends NEG
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. |
Nous vous recommandons d'utiliser |
||
| Équilibreur de charge réseau passthrough externe régional basé sur un service de backend |
Indique à GKE de créer un équilibreur de charge réseau passthrough externe régional. L'équilibreur de charge utilise des backends NEG
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. |
Nous vous recommandons d'utiliser |
||
| É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 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 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 |
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.
|
Toutes les versions prises en charge. | ||
| Adresses IP statiques |
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. |
|
||
| 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 |
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 Pour les services LoadBalancer internes, configurez BYOIPv6 en spécifiant un sous-réseau interne BYOIPv6 avec l'annotation |
(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 |
GKE version 1.18.19-gke.1400 ou ultérieure | ||
| ipFamilyPolicy |
Définit la façon dont GKE alloue les adresses IP à un service.
Vous pouvez définir Pour créer un service LoadBalancer IPv6 à pile unique dans un cluster à double pile, définissez la valeur de ce champ sur |
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) |
Définit la famille d'adresses IP à laquelle allouer des services à pile unique ou à double pile. Utilisez l'une des valeurs suivantes :
Pour un service LoadBalancer IPv6 à pile unique dans un cluster à double pile, définissez la valeur de ce champ sur |
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 |
Local |
Vous pouvez sélectionner un port personnalisé à l'aide de |
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 dekube-proxyetiptables(sur les clusters qui n'utilisent pas GKE Dataplane V2) ou decilium-agentet de règles eBPF (sur les clusters avec GKE Dataplane V2). Si le service n'inclut pasloadBalancerSourceRanges[], 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 plage2001: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 champloadBalancerSourceRanges[], 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
|
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:
|
É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 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 :
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 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 |
| 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 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.loadBalancerClassdéfini sur la valeurnetworking.gke.io/l4-regional-externaldans 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 IPv6INTERNAL(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 IPv6EXTERNAL(GUA). Le sous-réseau spécifié par cette annotation doit avoir un type d'accès IPv6 (EXTERNALouINTERNAL) 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é
|
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
|
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é
|
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
|
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
|
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 :
- Accès client dans la documentation de l'équilibreur de charge réseau passthrough interne
- Équilibreurs de charge réseau passthrough internes et réseaux connectés
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 les services LoadBalancer internes, le sous-paramètre GKE doit être activé. Le sous-paramètre GKE est activé par défaut pour les clusters IPv6 à pile unique et à double pile. Pour en savoir plus, découvrez comment activer le sous-paramètre d'équilibreur de charge interne.
- Pour les services LoadBalancer externes, vous devez utiliser un équilibreur de charge réseau passthrough externe régional basé sur un service de backend. Pour plus d'informations, consultez la page Équilibreur de charge réseau externe basé sur un service de backend.
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 ipFamiliesIPv4, mais pasIPv6. - Un service avec ipFamilies
["IPv6","IPv4"]peut devenir un service avec ipFamiliesIPv6, mais pasIPv4.
- Un service avec ipFamilies
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.loadBalancerIPpour spécifier une adresse IPv6. Utilisez plutôt l'annotationnetworking.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.ipFamiliessurIPv4ou de la valeur du champspec.ipFamilyPolicysurRequireDualStackest rejetée. - Vous ne pouvez utiliser l'annotation
networking.gke.io/ip-collection-v6que 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'annotationnetworking.gke.io/ip-collection-v6pour les services à double pile, les services IPv4 ou les services LoadBalancer internes. Vous ne pouvez pas combiner cette annotation avec l'annotationnetworking.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
- En savoir plus sur les services LoadBalancer
- Découvrez comment configurer un équilibreur de charge interne.
- Consultez la présentation d'Ingress pour les équilibreurs de charge d'application.
- Découvrez comment utiliser des NEG autonomes.
- Apprenez-en plus sur les règles de pare-feu VPC.