Parámetros de Services LoadBalancer

En esta página, se describen los parámetros para manifiestos de Services que controlan el comportamiento y la configuración de Services LoadBalancer. Antes de leer esta página, asegúrate de estar familiarizado con los conceptos de Services LoadBalancer de Google Kubernetes Engine (GKE).

Parámetros de servicio

GKE admite los siguientes parámetros para los Services LoadBalancer.

Parámetro Campo y descripción del Service Interno Externo Compatibilidad con las versiones
Balanceador de cargas de red de transferencia interno
  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal
  • networking.gke.io/load-balancer-type: "Internal"

Indica a GKE que cree un balanceador de cargas de red de transferencia interno.

El balanceador de cargas usa backends de NEG GCE_VM_IP si se cumple alguna de las siguientes condiciones:

  • El manifiesto del Service se aplica a un clúster que tiene habilitada la subdivisión de GKE.
  • El manifiesto de Service se aplica a un clúster que ejecuta la versión 1.36 o posterior de GKE. La subdivisión de GKE se habilita automáticamente en la versión 1.36 y posteriores de GKE.

En todas las demás situaciones, el balanceador de cargas usa backends de grupos de instancias. Para obtener más información, consulta Agrupación de nodos.

  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal: requiere la versión 1.33.1-gke.1779000 de GKE y versiones posteriores, y la subdivisión de GKE habilitada.
  • networking.gke.io/load-balancer-type: "Internal": todas las versiones compatibles.

Recomendamos spec.loadBalancerClass si tu clúster usa la versión 1.33.1-gke.1779000 o posterior de GKE y tiene habilitado el parámetro secundario de GKE. Este atributo es inmutable y no se puede cambiar después de que se haya aplicado el manifiesto de Service a un clúster.

Balanceador de cargas de red de transferencia externo regional basado en servicios de backend
  • Comportamiento predeterminado en GKE 1.37 y versiones posteriores
  • spec.loadBalancerClass: networking.gke.io/l4-regional-external
  • cloud.google.com/l4-rbs: "enabled"

Indica a GKE que cree un balanceador de cargas de red de transferencia externo regional.

El balanceador de cargas usa backends de NEG de GCE_VM_IP si se cumple alguna de las siguientes condiciones:

  • El Service se crea en un clúster que ejecuta la versión 1.37 o posterior de GKE. No se requieren anotaciones ni clases.
  • El manifiesto del Service incluye spec.loadBalancerClass: networking.gke.io/l4-regional-external y se aplica a un clúster que ejecuta la versión de GKE 1.33.1-gke.1779000 a 1.36.
  • El manifiesto del Service incluye la anotación cloud.google.com/l4-rbs: "enabled" y se aplica a un clúster que ejecuta la versión de GKE 1.32.2-gke.1652000 a 1.36.

En todas las demás situaciones, el balanceador de cargas usa backends de grupos de instancias. Para obtener más información, consulta Agrupación de nodos.

  • spec.loadBalancerClass: networking.gke.io/l4-regional-external: requiere la versión 1.33.1-gke.1779000 de GKE y versiones posteriores.
  • cloud.google.com/l4-rbs: "enabled": todas las versiones compatibles.

Recomendamos spec.loadBalancerClass si tu clúster usa la versión 1.33.1-gke.1779000 a 1.36 de GKE. Este atributo es inmutable y no se puede cambiar después de que se haya aplicado el manifiesto de Service a un clúster. En GKE 1.37 y versiones posteriores, no se necesitan campos para este tipo de balanceador de cargas.

Balanceo de cargas ponderado networking.gke.io/weighted-load-balancing: "pods-per-node"

Permite que los nodos que tienen más Pods de entrega reciban una mayor proporción de conexiones nuevas en comparación con los nodos que tienen menos Pods de entrega.

GKE 1.31.0+
Política de tráfico interno spec.internalTrafficPolicy

Cuando se configura con el valor Local, GKE solo enruta paquetes de Pods cliente en un nodo a Pods de entrega en el mismo nodo. Cuando se configura con el valor Cluster, GKE enruta los paquetes desde los Pods cliente en un nodo a los Pods de entrega en cualquier nodo. Para obtener más detalles, consulta la Política de tráfico interno del Service.

Este parámetro no es compatible con clústeres que ejecutan GKE Dataplane V2.

GKE 1.22+
Política de tráfico externo spec.externalTrafficPolicy

Controla cuáles VM del nodo pasan las verificaciones de estado del balanceador de cargas y cómo se enrutan los paquetes a los Pods que están listos y en funcionamiento en el clúster. También controla cómo los nodos se agrupan en los NEG GCE_VM_IP cuando la subdivisión de GKE está habilitada.

Para obtener más detalles, consulta los conceptos de Services LoadBalancer.

GKE 1.14+ (1.23.4-gke.400+ para el grupo de nodos de Windows).
Afinidad zonal spec.trafficDistribution: PreferSameZone

Habilita la afinidad zonal para los Services LoadBalancer internos. La afinidad zonal controla la zona a la que el balanceador de cargas de red de transferencia interno enruta el tráfico entrante para los clientes compatibles cuando es posible una coincidencia zonal. Para usar la afinidad zonal, debes habilitar la subdivisión de GKE (habilitada de forma predeterminada a partir de la versión 1.36 de GKE).

Para obtener más información, consulta Afinidad zonal y distribución del tráfico.

Versión preliminar en GKE 1.33.3-gke.1392000 y versiones posteriores. Disponibilidad general en GKE versión 1.36 y posteriores.
Puerto de verificación de estado spec.healthCheckNodePort

Implementa una verificación de estado del balanceador de cargas para los objetos Service de tipo LoadBalancer. Este parámetro solo es válido si spec.externalTrafficPolicy se configura como Local.

Todas las versiones compatibles.
Reglas de firewall y lista de direcciones IP de origen permitidas spec.loadBalancerSourceRanges

Configura reglas de firewall opcionales en GKE y en la red de VPC para permitir solo ciertos rangos de origen. kube-proxy también configura reglas de iptables para que coincidan con los rangos de origen especificados.

Todas las versiones compatibles.
Direcciones IP estáticas
  • spec.loadBalancerIP (solo IPv4)
  • networking.gke.io/load-balancer-ip-addresses

Especifica una dirección IPv4 estática, un rango de direcciones IPv6 estáticas o ambos, que se asignan a las reglas de reenvío del balanceador de cargas. Consulta Consideraciones para compartir una dirección IP común a fin de obtener información sobre los requisitos de configuración importantes y los detalles de implementación.

  • spec.loadBalancerIP: Todas las versiones compatibles.
  • networking.gke.io/load-balancer-ip-addresses: GKE 1.29 y versiones posteriores. Consulta Parámetros de direcciones IP estáticas para obtener requisitos adicionales de configuración o de anotación de clústeres.
Niveles de servicio de red cloud.google.com/network-tier

Especifica qué niveles de servicio de red usa GKE para la regla de reenvío externa y la dirección IP. Los valores válidos de anotación son Standard y Premium (configuración predeterminada).

GKE 1.19 y versiones posteriores.
Subred personalizada networking.gke.io/load-balancer-subnet
(solo se aplica a IPv6)
GKE 1.29 y versiones posteriores. Para conocer los requisitos adicionales, consulta Anotación de subred personalizada.
Usa tus propias direcciones IPv6 (BYOIPv6) networking.gke.io/ip-collection-v6: "projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME"

Especifica un subprefijo IPv6 regional de un prefijo delegado público (PDP) en modo EXTERNAL_IPV6_FORWARDING_RULE_CREATION. A partir de este subprefijo, GKE asigna un rango de direcciones IPv6 /96 externas efímeras para un Service LoadBalancer externo IPv6 de pila única. Puedes especificar el subprefijo como una URL de recurso completa o como la ruta de acceso parcial del recurso que se muestra en el ejemplo. Si cambias esta anotación, GKE vuelve a crear la regla de reenvío de IPv6 con una dirección nueva del prefijo nuevo. Si quitas la anotación, el Service vuelve a una dirección proporcionada por Google desde una subred con un rango de direcciones IPv6 externo. Si la subred del clúster tiene un rango de direcciones IPv6 interno, agrega la anotación networking.gke.io/load-balancer-subnet al mismo tiempo.

Para los Services LoadBalancer internos, configura BYOIPv6 especificando una subred interna de BYOIPv6 con la anotación networking.gke.io/load-balancer-subnet.


(solo se aplica a IPv6 de pila única)
Versión 1.37.1-gke.2097000 y posteriores de GKE
Acceso global networking.gke.io/internal-load-balancer-allow-global-access: "true"

Permite que los clientes de cualquier región de la red de VPC o una red conectada puedan acceder a la dirección IP de la regla de reenvío.

Vista previa en GKE 1.16+. Disponibilidad general en GKE 1.17.9-gke.600+.
Se reenvían todos los puertos

GKE configura de forma automática la regla de reenvío para usar todos los puertos si se especifican más de cinco puertos únicos (hasta 100) en spec.ports[].port.

Versión de GKE 1.18.19-gke.1400 o posterior
ipFamilyPolicy

spec.ipFamilyPolicy

Define cómo GKE asigna direcciones IP a un Service. Puedes definir spec.ipFamilyPolicy como SingleStack, PreferDualStack o RequireDualStack.

Para crear un Service LoadBalancer IPv6 de pila única en un clúster de pila doble, establece el valor de este campo en SingleStack y el valor del campo spec.ipFamilies en IPv6. En un clúster solo de IPv6, estos son los valores predeterminados y puedes omitirlos. Para obtener más información, consulta Objetos Service LoadBalancer IPv6.

Los clústeres de GKE en la versión 1.29 o posterior admiten la red de pila doble para los objetos Service de LoadBalancer.

Los objetos Service LoadBalancer IPv6 de pila única están disponibles en versión preliminar en GKE 1.36.0-gke.2646000 y versiones posteriores.
ipFamilies (opcional)

spec.ipFamilies

Define la familia de direcciones IP para asignar Services de pila única o doble. Usa cualquiera de los siguientes valores:

  • IPv4 solo para el servicio IPv4 de pila única.
  • IPv6 solo para el servicio IPv6.
  • IPv4,IPv6 para el servicio de pila doble en el que la dirección IP principal del servicio es IPv4.
  • IPv6,IPv4 para el servicio de pila doble en el que la dirección IP principal del servicio es IPv6.

Para un Service LoadBalancer IPv6 de pila única en un clúster de pila doble, establece el valor de este campo en IPv6 y el valor del campo spec.ipFamilyPolicy en SingleStack. En un clúster solo de IPv6, estos son los valores predeterminados y puedes omitirlos. Para obtener más información, consulta Objetos Service LoadBalancer IPv6.

Los clústeres de GKE en la versión 1.29 o posterior admiten la red de pila doble para los objetos Service de LoadBalancer.

Versión preliminar en GKE 1.36.0-gke.2646000 y versiones posteriores para Services de LoadBalancer de IPv6 de pila única.

Puerto de verificación de estado

Como se describe en Verificaciones de estado del balanceador de cargas, GKE siempre implementa una verificación de estado del balanceador de cargas cuando crea un balanceador de cargas de red de transferencia externo regional o un balanceador de cargas de red de transferencia interno.

Si puedes establecer el parámetro healthCheckNodePort o no depende de la siguiente configuración de externalTrafficPolicy:

externalTrafficPolicy Puerto de verificación de estado
Cluster

No puedes utilizar spec.healthCheckNodePort.

Local

Puedes seleccionar un puerto personalizado con spec.healthCheckNodePort. Si no se especifica, el plano de control de Kubernetes asigna un puerto de verificación de estado desde el rango de puertos del nodo.

Reglas de firewall y lista de entidades permitidas de direcciones IP de origen

A menos que hayas configurado un clúster para omitir la creación de reglas de firewall de VPC para los objetos Service de tipo LoadBalancer, GKE crea una regla de firewall de VPC de permiso de entrada para cada objeto Service.

Cada regla de firewall creada automáticamente tiene las siguientes características:

  • La dirección de la regla de firewall es de entrada y su acción es permitir. Las reglas de firewall de denegación de entrada implícitas en Google Cloud significan que GKE usa un modelo de lista de entidades permitidas cuando se crean reglas de firewall de entrada.
  • GKE establece el protocolo y el puerto de destino de la regla de firewall en aquellos especificados en la lista spec.ports[] del objeto Service.
  • GKE configura las reglas de firewall para los Services LoadBalancer estableciendo de forma explícita el parámetro de destino en la dirección IP virtual del LoadBalancer (la regla de reenvío del balanceador de cargas).
  • GKE establece el parámetro de destino de la regla de firewall para incluir todos los nodos del clúster.
  • Si el Service incluye spec.loadBalancerSourceRanges[], GKE establece el parámetro de origen de la regla de firewall en las direcciones IP de esa lista. Además, GKE configura rutas y reglas dentro del sistema operativo del nodo para limitar las direcciones IP de origen del tráfico con balanceo de cargas, con kube-proxy y iptables (en clústeres que no usan GKE Dataplane V2) o cilium-agent y reglas de eBPF (en clústeres con GKE Dataplane V2). Si el objeto Service no incluye loadBalancerSourceRanges[], GKE establece el parámetro de origen de la regla de firewall en todas las direcciones IP (0.0.0.0/0).
  • Para un Service LoadBalancer IPv6, especifica los rangos CIDR de IPv6 en el campo spec.loadBalancerSourceRanges[] (por ejemplo, el rango 2001:db8::/32). GKE crea una regla de firewall independiente para la regla de reenvío de IPv6 del Service. Si el Service no incluye el campo loadBalancerSourceRanges[], GKE establece el parámetro de origen de esa regla de firewall en todas las direcciones IPv6 (::/0).

Direcciones IP estáticas

Puedes crear una dirección IP estática y configurar GKE para que asigne esa dirección IP estática a la regla de reenvío del balanceador de cargas. El uso de una dirección IP estática ayuda a garantizar que la dirección IP del balanceador de cargas permanezca igual, incluso si realizas cambios en el Service LoadBalancer. Sin una dirección IP estática, GKE podría asignar una dirección IP diferente a la regla de reenvío del balanceador de cargas cuando actualizas un objeto Service LoadBalancer. La dirección IP de la regla de reenvío no es la misma que la dirección spec.clusterIP del Service. La dirección ClusterIP de un Service nunca cambia cuando actualizas un Service LoadBalancer.

Parámetros de dirección IP estática

Para indicarle a un Service LoadBalancer que use una dirección IP estática, usa el parámetro spec.loadBalancerIP o la anotación networking.gke.io/load-balancer-ip-addresses. En la versión 1.29 de GKE y versiones posteriores, la anotación tiene prioridad sobre spec.loadBalancerIP si el manifiesto del Service contiene el parámetro y la anotación.

Parámetro o anotación y valor Requisitos y capacidades
spec.loadBalancerIP:
IPv4_ADDRESS

Puedes especificar una dirección IPv4 interna estática para un Service de LoadBalancer interno solo IPv4. Puedes especificar una dirección IPv4 externa estática para un objeto Service LoadBalancer externo solo IPv4. El parámetro funciona con todas las versiones de GKE compatibles.

networking.gke.io/load-balancer-ip-addresses:
IP_ADDRESS_RESOURCE_NAME
  • Para los Services LoadBalancer de pila única, establece el valor de la anotación como el nombre del recurso de dirección IPv4 o IPv6, no en la dirección IP en sí.
  • Para los Services LoadBalancer de doble pila, establece el valor de la anotación como el nombre del recurso de dirección IPv4 estática y el nombre del recurso del rango de direcciones IPv6 estático separados por una coma.

Puedes especificar direcciones IPv4 estáticas, un rango de direcciones IPv6 estáticas o ambos para Services LoadBalancer internos y externos de pila doble, solo IPv4 y solo IPv6. La anotación requiere GKE 1.29 o una versión posterior y los siguientes requisitos adicionales:

  • Para usar esta anotación con un Service LoadBalancer interno, tu clúster debe tener habilitada la subdivisión de GKE. La subdivisión de GKE está habilitada de forma predeterminada en GKE 1.36 y versiones posteriores.
  • Para usar esta anotación con un Service LoadBalancer externo, debes establecer el campo spec.loadBalancerClass en el valor networking.gke.io/l4-regional-external en el manifiesto del Service cuando crees el Service LoadBalancer externo.
  • Para un Service LoadBalancer externo IPv6 de pila única en la versión 1.37.1-gke.2097000 y posteriores de GKE, también puedes reservar el rango de direcciones IPv6 estáticas de un prefijo público delegado de BYOIPv6 regional en el modo EXTERNAL_IPV6_FORWARDING_RULE_CREATION.
  • Para un Service LoadBalancer interno, puedes reservar el rango de direcciones IPv6 estáticas de una subred interna aprovisionada desde un prefijo delegado público de BYOIPv6 en el modo INTERNAL_IPV6_SUBNETWORK_CREATION.

Consideraciones para compartir una dirección IP común

Dos o más Services LoadBalancer pueden hacer referencia a la misma dirección IP estática si la regla de reenvío para cada balanceador de cargas usa una combinación única de dirección IP, protocolo, especificación de puerto y especificación de Niveles de servicio de red, como se indica en la tabla de esta sección. Además:

  • Las direcciones IPv6 estáticas en realidad son rangos de direcciones IPv6 /96, pero GKE solo configura los nodos para que acepten paquetes en la primera dirección IPv6 (/128) en el rango /96.

  • Para que dos o más Services LoadBalancer internos usen la misma dirección IPv4 interna, la dirección IP estática debe crearse con el propósito SHARED_LOADBALANCER_VIP.

Service LoadBalancer interno Servicio LoadBalancer externo
Especificación de puerto

Las reglas de reenvío para balanceadores de cargas de red de transferencia internos admiten hasta cinco números de puerto individuales o se pueden configurar para usar todos los puertos.

Cuando un Service LoadBalancer interno tiene más de cinco spec.ports[] especificados, GKE configura la regla de reenvío para que el balanceador de cargas de red de transferencia interno use todos los puertos.

Las reglas de reenvío con la misma dirección IP y el mismo protocolo no pueden tener puertos superpuestos. Esto significa que no puedes crear varios Services de LoadBalancer internos que compartan la misma dirección IP, el mismo protocolo y los mismos puertos. Por ejemplo:

  • Si creas un Service LoadBalancer interno con el puerto TCP 80, no puedes crear otro Service con los puertos TCP 80, 81 y 90 porque el puerto 80 se superpone.
  • Si un Service LoadBalancer interno usa los puertos TCP 80, 8080 y 90, no puedes crear otro Service que use TCP en todos los puertos, ya que esto también generaría una superposición de puertos.

Para obtener más información, consulta las reglas de reenvío del balanceador de cargas de red de transferencia interno que usan una dirección IP común.

En el caso de los clústeres que ejecutan versiones de GKE anteriores a la 1.37, GKE crea un balanceador de cargas de red de transferencia externo regional basado en grupos de destino si el manifiesto del Service LoadBalancer no tiene el campo spec.loadBalancerClass establecido en el valor networking.gke.io/l4-regional-external o no incluye la anotación cloud.google.com/l4-rbs: "enabled". En el caso de los clústeres que ejecutan GKE 1.37 o versiones posteriores, debes configurar spec.loadBalancerClass: "networking.gke.io/l4-regional-external-legacy" de forma explícita para crear un balanceador de cargas de red de transferencia externo regional basado en un grupo de destino.

Las reglas de reenvío para balanceadores de cargas de red de transferencia externos regionales basados en grupos de destino deben usar rangos de puertos contiguos. El rango de puertos contiguo incluye todos los puertos que necesita el Service, pero el rango también puede incluir puertos adicionales que el Service no usa. Por ejemplo, un Service LoadBalancer externo alimentado por un balanceador de cargas de red de transferencia externo regional basado en grupos de destino que especifica los puertos 80 y 443 en su manifiesto de Service usa una regla de reenvío del balanceador de cargas con un rango de puertos 80-443. Este rango de puertos evita que otros objetos Service LoadBalancer externos usen los puertos 80, 443 y cualquiera de los números entre el 80 y el 443.

De forma predeterminada, GKE crea un balanceador de cargas de red de transferencia externo regional basado en servicios de backend en las versiones 1.37 y posteriores. En versiones anteriores, GKE crea el balanceador de cargas si el manifiesto del Service LoadBalancer incluye el campo spec.loadBalancerClass establecido en el valor networking.gke.io/l4-regional-external. Las reglas de reenvío para balanceadores de cargas de red de transferencia externos regionales basados en servicios de backend admiten hasta cinco números de puerto discretos o un rango de puertos contiguo.

Niveles de servicio de red No configurable: las direcciones internas siempre son de nivel Premium.

Configurable para direcciones IPv4 externas regionales estáticas. Los rangos de direcciones IPv6 externas regionales estáticas solo se pueden crear en el nivel Premium.

La especificación de los niveles de servicio de red de la dirección IP externa estática debe coincidir con una de las siguientes opciones:

  • El nivel especificado en la anotación cloud.google.com/network-tier del manifiesto del Service LoadBalancer, si esa anotación está presente en el manifiesto, o
  • El nivel predeterminado del proyecto, si la anotación cloud.google.com/network-tier está ausente en el manifiesto del Service LoadBalancer.

El nivel predeterminado del proyecto es Premium, a menos que lo hayas configurado de manera diferente.

Reserva de dirección IP

GKE no reserva las direcciones IP estáticas configuradas con la anotación spec.loadBalancerIP o networking.gke.io/load-balancer-ip-addresses. Esto significa que la dirección IP que asignas a tu Service se puede liberar cuando se borra el Service.

Para mantener la dirección IP reservada, debes crear un recurso de dirección de forma manual en tu proyecto. La dirección IP estática debe tener los siguientes atributos:

  • Ser solo regional.
  • Estar en la misma región que el clúster.
  • Estar en los mismos Niveles de servicio de red que el Service LoadBalancer
  • Tener un nombre que no use el nombre del LoadBalancer, prefijos como k8s- o el UUID del Service.

Si no reservas la dirección por tu cuenta, los registros del proyecto pueden contener entradas sobre los recursos de dirección creados y quitados en poco tiempo. Esto forma parte del aprovisionamiento normal del servicio y es de esperar.

Subred de LoadBalancer

Puedes configurar un Service LoadBalancer interno para usar una dirección IPv4 efímera o estática, un rango de direcciones IPv6 o ambos, en una subred personalizada ubicada en la misma región y red de VPC que el clúster. Usa una subred personalizada para un Service LoadBalancer interno a fin de realizar las siguientes acciones:

  • Agrupa los balanceadores de cargas de red de transferencia internos creados por los Services LoadBalancer internos de dos o más clústeres de GKE en la misma red de VPC y región.
  • Crea Services LoadBalancer internos cuyos balanceadores de cargas de red de transferencia internos tengan direcciones IPv4 separadas de las direcciones IPv4 del nodo del clúster.
  • Crea Services LoadBalancer internos cuyos balanceadores de cargas de red de transferencia internos tengan rangos de direcciones IPv6 separados de las direcciones IPv6 del nodo y del Pod del clúster. Es obligatoria una subred LoadBalancer personalizada para admitir Services LoadBalancer internos si la subred del clúster tiene un rango de direcciones IPv6 externas.

Puedes configurar un Service LoadBalancer externo para usar un rango de direcciones IPv6 efímeras o estáticas en una subred personalizada que se encuentre en la misma región y red de VPC que el clúster. Usa una subred personalizada para crear objetos Service LoadBalancer externos cuyos balanceadores de cargas de red de transferencia externos regionales tengan rangos de direcciones IPv6 separados de las direcciones IPv6 del nodo y del Pod del clúster. Es obligatoria una subred LoadBalancer personalizada para admitir Services LoadBalancer externos si la subred del clúster tiene un rango de direcciones IPv6 interno.

Las direcciones IPv6 para los balanceadores de cargas de red de transferencia internos y los balanceadores de cargas de red de transferencia externos regionales suelen provenir de un rango de subredes en tu red de VPC. Para los Services LoadBalancer externos IPv6 de pila única en GKE versión 1.37.1-gke.2097000 y posteriores, las direcciones IPv6 pueden provenir de un prefijo delegado público de BYOIPv6. Cuando la dirección proviene de una subred, el tipo de acceso IPv6 de esa subred debe coincidir con el tipo de balanceador de cargas que creas: los Services LoadBalancer internos requieren una subred con un rango de direcciones IPv6 interno (incluidas las subredes aprovisionadas desde un prefijo BYOIPv6), y los Services LoadBalancer externos requieren una subred con un rango de direcciones IPv6 externo. Para obtener un resumen de cuándo se requiere una subred LoadBalancer personalizada, consulta Objetos Service LoadBalancer IPv6.

Anotación de subred personalizada

Usa la anotación networking.gke.io/load-balancer-subnet: SUBNET_RESOURCE_NAME para indicarle a un Service LoadBalancer que use una dirección IP estática o efímera en una subred personalizada, en la que SUBNET_RESOURCE_NAME es el nombre de la subred personalizada. Puedes usar esta anotación para especificar una subred personalizada para un Service LoadBalancer interno solo IPv4, solo IPv6 o de pila doble, o para un Service LoadBalancer externo solo IPv6 o de pila doble.

Para usar la anotación networking.gke.io/load-balancer-subnet, debes cumplir con los siguientes requisitos:

  • Tu clúster debe ejecutar la versión 1.29 de GKE o una posterior.
  • Para especificar una subred personalizada para un Service LoadBalancer interno, tu clúster debe tener habilitada la subdivisión de GKE. La subdivisión de GKE está habilitada de forma predeterminada en las versiones 1.36 y posteriores.
  • Para especificar una subred personalizada para un Service LoadBalancer externo, debes configurar un balanceador de cargas basado en servicios de backend. En la versión 1.37 y posteriores de GKE, esta configuración es el comportamiento predeterminado. En versiones anteriores, debes incluir el campo spec.loadBalancerClass establecido en el valor networking.gke.io/l4-regional-external en el manifiesto del Service cuando crees el Service LoadBalancer externo.
  • Para los clústeres IPv6 de pila única (creados con la marca --stack-type=ipv6), debes usar esta anotación cuando el tipo de acceso del balanceador de cargas difiera del tipo de acceso de la subred del nodo. Por ejemplo, usa esta anotación cuando implementes un Service LoadBalancer externo en un clúster cuya subred de nodo use el tipo de acceso IPv6 INTERNAL (ULA) o cuando implementes un Service LoadBalancer interno en un clúster cuya subred de nodo use el tipo de acceso IPv6 EXTERNAL (GUA). La subred que se especifica en esta anotación debe tener un tipo de acceso IPv6 (EXTERNAL o INTERNAL) que coincida con el tipo de balanceador de cargas correspondiente. Como alternativa, un Service LoadBalancer externo puede tomar su rango de direcciones IPv6 de un prefijo público delegado de BYOIPv6 en lugar de una subred. En ese caso, no uses esta anotación.

Subred y dirección IPv4 para un Service LoadBalancer interno

En la siguiente tabla, se describen las especificaciones de subred y las combinaciones de direcciones IPv4 válidas para un Service LoadBalancer interno solo IPv4 o de pila doble.

Dirección IPv4 estática Dirección IPv4 efímera
Subred personalizada
Subred personalizada y dirección IPv4 estática: la dirección IPv4 interna estática debe haberse creado en el rango de direcciones IPv4 principal de la subred personalizada. Subred personalizada y dirección IPv4 efímera: GKE usa una dirección IPv4 interna sin asignar en el rango de direcciones IPv4 principal de la subred personalizada.
Subred del clúster Subred del clúster y dirección IPv4 estática: La dirección IPv4 interna estática debe haberse creado en el rango de direcciones IPv4 principal de la subred del clúster. Subred del clúster y dirección IPv4 efímera: GKE usa una dirección IPv4 interna sin asignar en el rango de direcciones IPv4 principal de la subred del clúster.

Subred y rango de direcciones IPv6 para un Service LoadBalancer interno

En la siguiente tabla, se describen las combinaciones válidas de especificación de subred y rango de direcciones IPv6 para un Service LoadBalancer interno solo IPv6 o de pila doble. Aunque la regla de reenvío IPv6 del balanceador de cargas de red de transferencia interno usa un rango de direcciones IPv6 /96 interno, GKE solo configura nodos para aceptar paquetes cuyos destinos coincidan con la primera dirección IPv6 (/128) del rango /96 de la regla de reenvío.

Rango de direcciones IPv6 estáticas Rango de direcciones IPv6 efímero
Subred personalizada de pila doble o solo IPv6
  • Debe estar en la misma red de VPC y región que el clúster.
  • Debe tener un rango de direcciones IPv6 internas (tipo de acceso INTERNAL), que puede ser un rango de direcciones IPv6 internas proporcionado por Google o un rango de direcciones internas BYOIPv6 aprovisionado desde un prefijo delegado público que esté en modo INTERNAL_IPV6_SUBNETWORK_CREATION.
  • Se debe especificar con la anotación networking.gke.io/load-balancer-subnet.
Subred personalizada y rango de direcciones IPv6 estáticas: El rango de direcciones IPv6 internas /96 deben haberse creado en el rango de direcciones IPv6 interno /64 de la subred personalizada. Subred personalizada y rango de direcciones IPv6 efímeras: GKE usa un rango de direcciones IPv6 internas /96 sin asignar del rango de direcciones IPv6 interno /64 de la subred personalizada.
Subred de pila doble o solo IPv6 del clúster
  • Debe tener un rango de direcciones IPv6 internas (tipo de acceso INTERNAL), que puede ser un rango de direcciones IPv6 internas proporcionado por Google o un rango de direcciones internas BYOIPv6.
Subred del clúster y el rango de direcciones IPv6 estáticas: El rango de direcciones IPv6 internas /96 deben haberse creado en el rango de direcciones IPv6 interno /64 de la subred del clúster. Subred del clúster y rango de direcciones IPv6 efímeras: GKE usa un rango de direcciones IPv6 internas /96 no asignado del rango de direcciones IPv6 interno /64 de la subred del clúster.

Subred y dirección IPv4 para un Service LoadBalancer externo

Para los Services LoadBalancer externos de pila doble y solo IPv4, la dirección IPv4 externa (ya sea una dirección IPv4 externa estática o una dirección IPv4 externa efímera) no viene desde una subred.

Subred y rango de direcciones IPv6 para un Service LoadBalancer externo

En la siguiente tabla, se describen las combinaciones válidas de subred o subprefijo y rango de direcciones IPv6 para un Service LoadBalancer externo de pila doble o IPv6 de pila única. Aunque la regla de reenvío IPv6 del balanceador de cargas de red de transferencia externo regional usa un rango de direcciones IPv6 /96 externo, GKE solo configura nodos para aceptar paquetes cuyos destinos coincidan con la primera dirección IPv6 (/128) del rango /96 de la regla de reenvío.

Rango de direcciones IPv6 estáticas Rango de direcciones IPv6 efímero
Subred personalizada de pila doble o solo IPv6
Subred personalizada y rango de direcciones IPv6 estáticas: El rango de direcciones IPv6 externas estáticas /96 debe haberse creado en el rango de direcciones IPv6 externas /64 de la subred personalizada. Los rangos de direcciones IPv6 externas estáticas solo se pueden crear en el nivel Premium. Subred personalizada y rango de direcciones IPv6 efímeras: GKE usa un rango de direcciones IPv6 externas /96 sin asignar del rango de direcciones IPv6 externas /64 de la subred personalizada.
Subred de pila doble o solo IPv6 del clúster
  • Debe tener un rango de direcciones IPv6 externas (tipo de acceso EXTERNAL).
Subred del clúster y rango de direcciones IPv6 estáticas: El rango de direcciones IPv6 externas estáticas /96 debe haberse creado en el rango de direcciones IPv6 externas /64 de la subred del clúster. Los rangos de direcciones IPv6 externas estáticas solo se pueden crear en el nivel Premium. Subred del clúster y rango de direcciones IPv6 efímeras: GKE usa un rango de direcciones IPv6 externas /96 sin asignar del rango de direcciones IPv6 externo /64 de la subred del clúster.
Prefijo público delegado de BYOIPv6
  • Solo se aplica a los objetos Service LoadBalancer externos de IPv6 de pila única en la versión 1.37.1-gke.2097000 y posteriores de GKE.
  • El subprefijo regional debe estar en la misma región que el clúster, debe usar el modo EXTERNAL_IPV6_FORWARDING_RULE_CREATION y debe tener una longitud de prefijo asignable de /96.
  • El subprefijo debe tener el estado ANNOUNCED.
  • Funciona en clústeres IPv6 de pila única y en clústeres de pila doble (el Service en sí debe ser IPv6 de pila única). La subred del clúster puede tener un rango de direcciones IPv6 interno o externo (tipo de acceso INTERNAL o EXTERNAL). No se requiere una subred IPv6 externa porque el rango de direcciones proviene del subprefijo.
  • Requiere un balanceador de cargas de red de transferencia externo regional basado en servicios de backend (spec.loadBalancerClass: networking.gke.io/l4-regional-external) en el nivel Premium.
Prefijo de BYOIPv6 y rango de direcciones IPv6 estáticas: Debes reservar el rango de direcciones IPv6 externas estáticas /96 del subprefijo regional con las marcas --endpoint-type=NETLB y --ip-collection, y hacer referencia a la dirección estática con la anotación networking.gke.io/load-balancer-ip-addresses. De manera opcional, también puedes incluir la anotación networking.gke.io/ip-collection-v6. Si lo haces, esta anotación debe hacer referencia al mismo subprefijo del que reservaste la dirección estática. Prefijo BYOIPv6 y rango de direcciones IPv6 efímeras: Especifica el subprefijo regional con la anotación networking.gke.io/ip-collection-v6. GKE asigna un rango de direcciones IPv6 /96 externo disponible del prefijo secundario.

Acceso global

Cuando la anotación networking.gke.io/internal-load-balancer-allow-global-access es false o no se especifica para un Service LoadBalancer interno, GKE crea un balanceador de cargas de red de transferencia interno cuya regla de reenvío tiene inhabilitado el acceso global. Cuando el acceso global está inhabilitado, los clientes que necesitan acceder al balanceador de cargas deben estar ubicados en la misma región y red de VPC, o en una red conectada a la red de VPC del clúster.

Cuando la anotación networking.gke.io/internal-load-balancer-allow-global-access es true para un Service LoadBalancer interno, GKE habilita la opción de acceso global en la regla de reenvío del balanceador de cargas de red de transferencia interno. Los clientes ubicados en cualquier región de la red de VPC o una red conectada a la red de VPC del clúster pueden acceder al balanceador de cargas.

Para obtener más información sobre el acceso global a los clientes de una red conectada, consulta:

Todas las reglas de redirección de puertos

Las reglas de reenvío para balanceadores de cargas de red de transferencia internos admiten cinco números de puerto únicos o todos los puertos.

En GKE, un objeto Service LoadBalancer interno solo puede admitir hasta 100 puertos en el spec.ports[].port del Service. Si un Service LoadBalancer interno define hasta cinco puertos, la regla de reenvío incluirá esos puertos específicos. Sin embargo, si el Service especifica más de cinco puertos, la regla de reenvío se configurará automáticamente para que coincida con todos los puertos. Cuando configuras una regla de reenvío para usar todos los puertos, GKE solo crea reglas de firewall de permiso de entrada para los puertos específicos configurados en spec.ports[].port en el Service.

Para obtener más información sobre las reglas de reenvío del balanceador de cargas de red de transferencia interno y las especificaciones de puertos válidas, consulta Reglas de reenvío y especificaciones de puertos.

Service LoadBalancer de pila doble IPv4/IPv6

Puedes crear un objeto Service LoadBalancer interno o externo que pueda ser de pila única (solo IPv4 o IPv6) o de pila doble. Los objetos Service LoadBalancer de pila única crean una sola regla de reenvío con una dirección IPv4 o IPv6. Los objetos Service LoadBalancer de doble pila crean dos reglas de reenvío: una con una dirección IPv4 y otra con una dirección IPv6. Para crear un Service LoadBalancer de pila doble IPv4/IPv6, impleméntalo en un clúster de pila doble de IPv4/IPv6 y completa cualquiera de las siguientes opciones según el tipo de balanceador de cargas que uses:

  • Para los objetos Service LoadBalancer internos, debes tener habilitada la subdivisión de GKE. La subdivisión de GKE está habilitada de forma predeterminada para los clústeres de pila única IPv6 y de pila doble. Para obtener más información, consulta Subdivisión del balanceador de cargas interno.
  • Para los objetos Service LoadBalancer externos, debes usar un balanceador de cargas de red de transferencia externo regional basado en servicios de backend. Para obtener más información, consulta Balanceador de cargas de red externo basado en servicios de backend.

Para cada servicio, puedes definir las especificaciones ipFamilyPolicy y ipFamilies. Para obtener más información, consulta Pila doble de IPv4/IPv6.

Restricciones de Service LoadBalancer de pila doble

  • Los objetos Service LoadBalancer con direcciones IPv6 no son compatibles con los clústeres con el tipo de pila ipv4. Para obtener más información, consulta Usa una dirección IP de pila doble para un clúster nativo de la VPC o Configura un clúster IPv6 de pila única.
  • Los objetos Service LoadBalancer creados con una dirección de pila única no se pueden actualizar a servicios de pila doble.

  • Los objetos Service LoadBalancer creados con direcciones de pila doble se pueden cambiar a una sola pila según las siguientes condiciones:

    • Un Service con ipFamilies ["IPv4","IPv6"] se puede cambiar a uno con ipFamilies IPv4, pero no con IPv6.
    • Un Service con ipFamilies ["IPv6","IPv4"] se puede cambiar a uno con ipFamilies IPv6, pero no con IPv4.

Servicios LoadBalancer IPv6

Un Service LoadBalancer IPv6 es un Service LoadBalancer cuya regla de reenvío tiene una dirección IPv6. Un Service puede ser de pila única IPv6 o de pila doble con una regla de reenvío IPv4 y una IPv6. Para crear un Service LoadBalancer IPv6 de pila única en un clúster de pila doble, establece el valor del campo spec.ipFamilyPolicy en SingleStack y el valor del campo spec.ipFamilies en IPv6. En un clúster solo de IPv6, estos son los valores predeterminados y puedes omitirlos.

Los Services LoadBalancer IPv6 siempre usan backends de NEG GCE_VM_IP, y sus direcciones IPv6 provienen de un rango de subred en tu red de VPC o de un prefijo público delegado de IPv6 propio (BYOIPv6).

Los objetos Service LoadBalancer IPv6 de pila única están disponibles en versión preliminar en la versión 1.36.0-gke.2646000 y posteriores de GKE.

Restricciones de los Services LoadBalancer IPv6

  • No puedes usar el campo spec.loadBalancerIP para especificar una dirección IPv6. En su lugar, usa la anotación networking.gke.io/load-balancer-ip-addresses.
  • Los Services LoadBalancer IPv6 externos, incluidos los rangos de direcciones IPv6 externas estáticas, solo se admiten en el nivel Premium. GKE rechaza los objetos Service LoadBalancer IPv6 externos que configuran la anotación cloud.google.com/network-tier: Standard.
  • No puedes cambiar un Service LoadBalancer IPv6 de pila única para que use una dirección IPv4. Se rechaza establecer el valor del campo spec.ipFamilies en IPv4 o establecer el valor del campo spec.ipFamilyPolicy en RequireDualStack.
  • Puedes usar la anotación networking.gke.io/ip-collection-v6 solo en Services LoadBalancer externos IPv6 de pila única en GKE 1.37.1-gke.2097000 y versiones posteriores. GKE no admite la anotación networking.gke.io/ip-collection-v6 para Services de pila doble, Services IPv4 ni Services LoadBalancer internos, y no puedes combinar esta anotación con la anotación networking.gke.io/load-balancer-subnet.

Elige una subred para el balanceador de cargas

El tipo de acceso IPv6 de la subred que proporciona la dirección IP del balanceador de cargas debe coincidir con el tipo de balanceador de cargas. Si la subred del clúster ya tiene el tipo de acceso requerido, GKE usa la subred del clúster. De lo contrario, debes crear una subred de LoadBalancer personalizada con el tipo de acceso requerido y especificar esta subred con la anotación networking.gke.io/load-balancer-subnet. La única excepción es un Service LoadBalancer externo que usa un prefijo delegado público de BYOIPv6, ya que ese prefijo proporciona el rango de direcciones IPv6, independientemente del tipo de acceso de la subred del clúster.

En la siguiente tabla, se resume qué subred o prefijo proporciona el rango de direcciones IPv6 del balanceador de cargas:

Tipo de Service LoadBalancer Tipo de acceso IPv6 de la subred del clúster Fuente del rango de direcciones IPv6 del balanceador de cargas
Interno INTERNAL La subred del clúster. No se requiere anotación.
Interno EXTERNAL Una subred de LoadBalancer personalizada con un tipo de acceso IPv6 INTERNAL, especificada con la anotación networking.gke.io/load-balancer-subnet.
Interna con BYOIPv6 INTERNAL o EXTERNAL Una subred cuyo rango de direcciones IPv6 internas proviene de un prefijo público delegado de BYOIPv6 en modo INTERNAL_IPV6_SUBNETWORK_CREATION, especificado con la anotación networking.gke.io/load-balancer-subnet (no se requiere ninguna anotación si esa subred es la subred del clúster).
Externo EXTERNAL La subred del clúster. No se requiere anotación.
Externo INTERNAL Una subred de LoadBalancer personalizada con un tipo de acceso IPv6 EXTERNAL, especificada con la anotación networking.gke.io/load-balancer-subnet.
Externa con BYOIPv6
(GKE 1.37.1-gke.2097000 y versiones posteriores)
INTERNAL o EXTERNAL Un prefijo público delegado de BYOIPv6 en modo EXTERNAL_IPV6_FORWARDING_RULE_CREATION, especificado con la anotación networking.gke.io/ip-collection-v6 o por una dirección IPv6 estática reservada del prefijo. No especifiques la anotación networking.gke.io/load-balancer-subnet.

Para conocer las combinaciones válidas de subred y rango de direcciones IPv6, consulta Subred y rango de direcciones IPv6 para un Service LoadBalancer interno y Subred y rango de direcciones IPv6 para un Service LoadBalancer externo.

Traslada tus propias direcciones IPv6 (BYOIPv6)

Puedes trasladar tus propias direcciones IPv6 (BYOIPv6) con los Services LoadBalancer IPv6 internos y externos.

Para los servicios LoadBalancer externos, que asignan direcciones directamente desde un prefijo público delegado, el agente de servicio de GKE (service-PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com) requiere permisos específicos de Identity and Access Management (IAM). Otorga el rol de administrador de IP públicas de Compute (roles/compute.publicIpAdmin) a este agente en el proyecto que posee el prefijo delegado público. Esta función incluye el permiso compute.publicDelegatedPrefixes.use.

GKE requiere este permiso durante la creación inicial del Service y cada vez que se sincroniza.

Servicios LoadBalancer externos (GKE versión 1.37.1-gke.2097000 y posteriores): Los servicios LoadBalancer externos IPv6 de pila única (spec.ipFamilyPolicy: SingleStack y spec.ipFamilies: ["IPv6"]) asignan rangos de direcciones BYOIPv6 /96 externos directamente desde un subprefijo IPv6 regional de un prefijo delegado público (PDP). GKE admite esta función en clústeres IPv6 de pila única y de pila doble, siempre que el Service sea IPv6 de pila única. La subred del clúster puede tener un tipo de acceso IPv6 interno o externo, ya que el rango de direcciones se origina en el subprefijo, en lugar de una subred.

El subprefijo IPv6 regional debe cumplir con los siguientes requisitos:

  • Se configuró con el modo EXTERNAL_IPV6_FORWARDING_RULE_CREATION
  • Se configuró con una longitud de prefijo asignable de /96
  • En el estado ANNOUNCED

Para asignar un rango de direcciones BYOIPv6 externo efímero, especifica el subprefijo en la anotación networking.gke.io/ip-collection-v6 (proporcionada como una URL de recurso completa o la ruta de acceso parcial del recurso projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME). Como alternativa, para usar un rango de direcciones BYOIPv6 externo estático que reservaste del subprefijo, usa la anotación networking.gke.io/load-balancer-ip-addresses.

Si cambias la anotación networking.gke.io/ip-collection-v6, GKE vuelve a crear la regla de reenvío de IPv6 con una dirección nueva del prefijo nuevo, lo que interrumpe el tráfico brevemente. Si quitas la anotación, el Service vuelve a una dirección proporcionada por Google desde una subred con un rango de direcciones IPv6 externas. Si la subred del clúster usa un rango de direcciones IPv6 internas, para evitar errores, debes agregar de forma simultánea la anotación networking.gke.io/load-balancer-subnet. Para obtener más información, consulta Usa tus propias direcciones IPv6 (BYOIPv6) para un Service LoadBalancer externo.

Services LoadBalancer internos: Los Services LoadBalancer internos IPv6 usan direcciones BYOIPv6 de una subred IPv6 interna. Creas esta subred a partir de un subprefijo IPv6 regional de un prefijo delegado público (PDP) configurado en modo INTERNAL_IPV6_SUBNETWORK_CREATION. Para obtener más información, consulta Crea y usa subprefijos IPv6.

Para configurar el Service, especifica la subred de BYOIPv6 con la anotación networking.gke.io/load-balancer-subnet o usa esa subred como la subred predeterminada del clúster. De forma opcional, especifica una dirección BYOIPv6 interna estática reservada con la anotación networking.gke.io/load-balancer-ip-addresses.

Los Services LoadBalancer internos no admiten la anotación networking.gke.io/ip-collection-v6. Si aplicas esta anotación, GKE la ignora y emite un evento de advertencia IPCollectionV6Error. Para obtener más información, consulta Usa tus propias direcciones IPv6 (BYOIPv6) para un objeto Service LoadBalancer interno.

¿Qué sigue?