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 |
Indica a GKE que cree un balanceador de cargas de red de transferencia interno. El balanceador de cargas usa backends de NEG
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. |
Recomendamos |
||
| Balanceador de cargas de red de transferencia externo regional basado en servicios de backend |
Indica a GKE que cree un balanceador de cargas de red de transferencia externo regional. El balanceador de cargas usa backends de NEG de
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. |
Recomendamos |
||
| 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 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 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 |
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.
|
Todas las versiones compatibles. | ||
| Direcciones IP estáticas |
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. |
|
||
| 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 |
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 Para los Services LoadBalancer internos, configura BYOIPv6 especificando una
subred interna de BYOIPv6 con la
anotación |
(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 |
Versión de GKE 1.18.19-gke.1400 o posterior | ||
| ipFamilyPolicy |
Define cómo GKE asigna direcciones IP a un Service.
Puedes definir Para crear un Service LoadBalancer IPv6 de pila única en un clúster de pila doble, establece el valor de este campo en |
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) |
Define la familia de direcciones IP para asignar Services de pila única o doble. Usa cualquiera de los siguientes valores:
Para un Service LoadBalancer IPv6 de pila única en un clúster de pila doble, establece el valor de este campo en |
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 |
Local |
Puedes seleccionar un puerto personalizado con |
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, conkube-proxyyiptables(en clústeres que no usan GKE Dataplane V2) ocilium-agenty reglas de eBPF (en clústeres con GKE Dataplane V2). Si el objeto Service no incluyeloadBalancerSourceRanges[], 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 rango2001: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 campoloadBalancerSourceRanges[], 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
|
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:
|
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
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:
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 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 |
| 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 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.loadBalancerClassestablecido en el valornetworking.gke.io/l4-regional-externalen 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 IPv6INTERNAL(ULA) o cuando implementes un Service LoadBalancer interno en un clúster cuya subred de nodo use el tipo de acceso IPv6EXTERNAL(GUA). La subred que se especifica en esta anotación debe tener un tipo de acceso IPv6 (EXTERNALoINTERNAL) 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
|
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
|
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
|
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
|
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:
- Acceso del cliente en la documentación del balanceador de cargas de red de transferencia interno
- Balanceadores de cargas de red de transferencia internos y redes conectadas
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 ipFamiliesIPv4, pero no conIPv6. - Un Service con ipFamilies
["IPv6","IPv4"]se puede cambiar a uno con ipFamiliesIPv6, pero no conIPv4.
- Un Service con ipFamilies
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.loadBalancerIPpara especificar una dirección IPv6. En su lugar, usa la anotaciónnetworking.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.ipFamiliesenIPv4o establecer el valor del campospec.ipFamilyPolicyenRequireDualStack. - Puedes usar la anotación
networking.gke.io/ip-collection-v6solo en Services LoadBalancer externos IPv6 de pila única en GKE 1.37.1-gke.2097000 y versiones posteriores. GKE no admite la anotaciónnetworking.gke.io/ip-collection-v6para Services de pila doble, Services IPv4 ni Services LoadBalancer internos, y no puedes combinar esta anotación con la anotaciónnetworking.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?
- Obtén información sobre los objetos Service LoadBalancer.
- Obtén más información para configurar un balanceador de cargas interno.
- Lee una descripción general de Ingress para balanceadores de cargas de aplicaciones.
- Obtén más información para usar NEG independientes.
- Obtén más información sobre las reglas de firewall de VPC.