Parâmetros de Serviço LoadBalancer

Nesta página, descrevemos os parâmetros de manifestos de Serviço que controlam o comportamento e a configuração do Serviço LoadBalancer. Antes de ler esta página, confira os conceitos do Serviço LoadBalancer do Google Kubernetes Engine (GKE).

Parâmetros de serviço

O GKE aceita os parâmetros a seguir para Serviços LoadBalancer.

Parâmetro Campo e descrição do serviço Interno Externo Compatibilidade das versões
Balanceador de carga de rede de passagem interno
  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal
  • networking.gke.io/load-balancer-type: "Internal"

Instrui o GKE a criar um balanceador de carga de rede de passagem interna.

O balanceador de carga usará back-ends de NEG GCE_VM_IP se uma das seguintes condições for verdadeira:

  • O manifesto de serviço é aplicado a um cluster que tem a subconfiguração do GKE ativada.
  • O manifesto de serviço é aplicado a um cluster que executa o GKE versão 1.36 ou posterior. A criação de subconjuntos do GKE é ativada automaticamente no GKE versão 1.36 e mais recentes.

Em todas as outras situações, o balanceador de carga usa back-ends de grupo de instâncias. Para mais informações, consulte Agrupamento de nós.

  • spec.loadBalancerClass: networking.gke.io/l4-regional-internal: requer o GKE versão 1.33.1-gke.1779000 e posterior e a criação de subconjuntos do GKE ativada.
  • networking.gke.io/load-balancer-type: "Internal": todas as versões compatíveis.

Recomendamos spec.loadBalancerClass se o cluster usar a versão 1.33.1-gke.1779000 ou posterior do GKE e tiver o subconjunto do GKE ativado. Esse atributo é imutável e não pode ser alterado depois que o manifesto do Serviço é aplicado a um cluster.

Balanceador de carga de rede de passagem externa regional baseado em serviço de back-end
  • Comportamento padrão no GKE 1.37 e versões mais recentes
  • spec.loadBalancerClass: networking.gke.io/l4-regional-external
  • cloud.google.com/l4-rbs: "enabled"

Instrui o GKE a criar um balanceador de carga de rede de passagem externa regional.

O balanceador de carga usará back-ends de NEG GCE_VM_IP se alguma das seguintes condições for verdadeira:

  • O serviço é criado em um cluster que executa o GKE versão 1.37 ou posterior. Nenhuma anotação ou classe é necessária.
  • O manifesto do serviço inclui spec.loadBalancerClass: networking.gke.io/l4-regional-external e é aplicado a um cluster que executa o GKE versão 1.33.1-gke.1779000 a 1.36.
  • O manifesto do serviço inclui a anotação cloud.google.com/l4-rbs: "enabled" e é aplicado a um cluster que executa as versões 1.32.2-gke.1652000 a 1.36 do GKE.

Em todas as outras situações, o balanceador de carga usa back-ends de grupo de instâncias. Para mais informações, consulte Agrupamento de nós.

  • spec.loadBalancerClass: networking.gke.io/l4-regional-external: requer a versão 1.33.1-gke.1779000 ou posterior do GKE.
  • cloud.google.com/l4-rbs: "enabled": todas as versões compatíveis.

Recomendamos spec.loadBalancerClass se o cluster usar as versões 1.33.1-gke.1779000 a 1.36 do GKE. Esse atributo é imutável e não pode ser alterado depois que o manifesto do Serviço é aplicado a um cluster. No GKE 1.37 e versões mais recentes, nenhum campo é necessário para esse tipo de balanceador de carga.

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

Permite que os nós com mais pods de exibição recebam uma proporção maior de novas conexões em comparação com os nós com menos pods de exibição.

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

Quando definido como o valor Local, o GKE só encaminha pacotes de pods de clientes em um nó para pods de exibição no mesmo nó. Quando definido como o valor Cluster, o GKE encaminha pacotes de pods de clientes em um nó para pods de exibição em qualquer nó. Para mais detalhes, consulte a Política de tráfego interno do serviço.

Esse parâmetro não oferece suporte aos clusters que executam o GKE Dataplane V2.

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

Controla quais VMs de nó passam nas verificações de integridade do balanceador de carga e como os pacotes são encaminhados para os pods prontos e disponibilizados no cluster. Controla também como os nós são agrupados em NEGs GCE_VM_IP quando o Subagrupamento do GKE está ativado.

Para detalhes, consulte Conceitos do Serviço LoadBalancer.

GKE 1.14 ou superior (1.23.4-gke.400+ para pool de nós do Windows)
Afinidade zonal spec.trafficDistribution: PreferSameZone

Ativa a afinidade zonal para serviços LoadBalancer internos. A afinidade zonal controla a zona para que o balanceador de carga de rede de passagem interna encaminha o tráfego de entrada para clientes compatíveis quando uma correspondência zonal é possível. Para usar a afinidade zonal, ative a criação de subconjuntos do GKE (ativada por padrão a partir da versão 1.36 do GKE).

Para mais informações, consulte Afinidade zonal e distribuição de tráfego.

Pré-lançamento no GKE 1.33.3-gke.1392000 e versões mais recentes. Disponibilidade geral no GKE versão 1.36 e posterior.
Porta de verificação de integridade spec.healthCheckNodePort

Implanta uma verificação de integridade do balanceador de carga para os serviços LoadBalancer. Esse parâmetro só será válido se spec.externalTrafficPolicy for definido como Local.

Todas as versões compatíveis
Regras de firewall e lista de permissões de endereços IP de origem spec.loadBalancerSourceRanges

Configura regras de firewall opcionais no GKE e na rede VPC para permitir apenas determinados intervalos de origem. O kube-proxy também configura regras iptables para corresponder aos intervalos de origem especificados.

Todas as versões compatíveis
Endereços IP estáticos
  • spec.loadBalancerIP (somente IPv4)
  • networking.gke.io/load-balancer-ip-addresses

Especifica um endereço IPv4 estático, um intervalo de endereços IPv6 estático ou ambos atribuídos às regras de encaminhamento do balanceador de carga. Consulte Considerações para compartilhar um endereço IP comum para requisitos de configuração e detalhes de implementação importantes.

  • spec.loadBalancerIP: todas as versões compatíveis
  • networking.gke.io/load-balancer-ip-addresses: GKE 1.29 e posterior. Consulte Parâmetros de endereço IP estático para ver outros requisitos de configuração ou anotação do cluster.
Níveis de serviço de rede cloud.google.com/network-tier

Especifica quais Níveis de serviço de rede o GKE usa para a regra de encaminhamento externa e o endereço IP. Os valores válidos de anotação são Standard e Premium (padrão).

GKE 1.19 e posterior.
Sub-rede personalizada networking.gke.io/load-balancer-subnet
(aplicável somente a IPv6)
GKE 1.29 e posterior. Para outros requisitos, consulte Anotação de sub-rede personalizada.
Traga seus próprios endereços IPv6 (BYOIPv6) networking.gke.io/ip-collection-v6: "projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME"

Especifica um subprefixo IPv6 regional de um prefixo delegado público (PDP) no modo EXTERNAL_IPV6_FORWARDING_RULE_CREATION. Nesse subprefixo, o GKE aloca um intervalo de endereços IPv6 /96 externo temporário para um serviço LoadBalancer externo IPv6 de pilha única. É possível especificar o subprefixo como um URL de recurso completo ou como o caminho de recurso parcial mostrado no exemplo. Se você alterar essa anotação, o GKE vai recriar a regra de encaminhamento IPv6 com um novo endereço do novo prefixo. Se você remover a anotação, o Serviço vai reverter para um endereço fornecido pelo Google de uma sub-rede com um intervalo de endereços IPv6 externo. Se a sub-rede do cluster tiver um intervalo de endereços IPv6 interno, adicione a anotação networking.gke.io/load-balancer-subnet ao mesmo tempo.

Para serviços LoadBalancer internos, configure o BYOIPv6 especificando uma sub-rede interna BYOIPv6 com a anotação networking.gke.io/load-balancer-subnet.


(aplicável somente a IPv6 de pilha única)
GKE versão 1.37.1-gke.2097000 e mais recente
Acesso global networking.gke.io/internal-load-balancer-allow-global-access: "true"

Permite que o endereço IP da regra de encaminhamento seja acessível por clientes em qualquer região da rede VPC ou de uma rede conectada.

Visualização no GKE 1.16+. Geralmente disponível no GKE 1.17.9-gke.600+.
Todas as portas

O GKE configura automaticamente a regra de encaminhamento para usar todas as portas se mais de cinco (até 100) portas únicas forem especificadas em spec.ports[].port.

GKE versão 1.18.19-gke.1400 ou posterior
ipFamilyPolicy

spec.ipFamilyPolicy

Define como o GKE aloca endereços IP para um serviço. Defina spec.ipFamilyPolicy como SingleStack, PreferDualStack ou RequireDualStack.

Para criar um serviço LoadBalancer IPv6 de pilha única em um cluster de pilha dupla, defina o valor desse campo como SingleStack e defina o valor do campo spec.ipFamilies como IPv6. Em um cluster somente IPv6, esses são os valores padrão e podem ser omitidos. Para mais informações, consulte Serviços LoadBalancer IPv6.

Os clusters do GKE na versão 1.29 ou posterior são compatíveis com redes de pilha dupla para serviços LoadBalancer.

Os serviços de LoadBalancer IPv6 de pilha única estão disponíveis em pré-lançamento no GKE versão 1.36.0-gke.2646000 e posterior.
ipFamilies (opcional)

spec.ipFamilies

Define a família de endereços IPs para alocar serviços de pilha única ou de pilha dupla. Use um dos seguintes valores:

  • IPv4 apenas para serviço IPv4 de pilha única.
  • IPv6 somente para o serviço IPv6.
  • IPv4,IPv6 para serviço de pilha dupla, em que o endereço IP principal do serviço é IPv4.
  • IPv6,IPv4 para serviço de pilha dupla, em que o endereço IP principal do serviço é IPv6.

Para um serviço LoadBalancer IPv6 de pilha única em um cluster de pilha dupla, defina o valor desse campo como IPv6 e o valor do campo spec.ipFamilyPolicy como SingleStack. Em um cluster somente IPv6, esses são os valores padrão, que podem ser omitidos. Para mais informações, consulte Serviços LoadBalancer IPv6.

Os clusters do GKE na versão 1.29 ou posterior são compatíveis com redes de pilha dupla para serviços LoadBalancer.

Pré-lançamento na versão 1.36.0-gke.2646000 e posteriores do GKE para serviços LoadBalancer IPv6 de pilha única.

Porta de verificação de integridade

Conforme descrito em Verificações de integridade do balanceador de carga, o GKE sempre implanta uma verificação de integridade do balanceador de carga ao criar um balanceador de carga de rede de passagem externo regional ou um balanceador de carga de rede de passagem interno.

A configuração do parâmetro healthCheckNodePort depende da configuração a seguir do externalTrafficPolicy:

externalTrafficPolicy Porta de verificação de integridade
Cluster

Não é possível usar o spec.healthCheckNodePort.

Local

É possível selecionar uma porta personalizada usando o spec.healthCheckNodePort. Se não for especificado, o plano de controle do Kubernetes atribuirá uma porta de verificação de integridade a partir do intervalo de portas do nó.

Regras de firewall e lista de permissões de endereços IP de origem

A menos que você tenha configurado um cluster para pular a criação de regras de firewall da VPC para serviços de LoadBalancer, o GKE cria uma regra de firewall da VPC de permissão de entrada para cada serviço.

Cada regra de firewall criada automaticamente tem as seguintes características:

  • A direção da regra de firewall é de entrada e a ação dela é permitida. As regras de firewall de entrada de negação implícitas no Google Cloud significam que o GKE usa um modelo de lista de permissões ao criar regras de firewall de entrada.
  • O GKE define o protocolo e a porta de destino da regra de firewall como especificados na lista spec.ports[] do serviço.
  • O GKE configura regras de firewall para serviços LoadBalancer definindo explicitamente o parâmetro de destino como o endereço IP virtual do LoadBalancer (a regra de encaminhamento do balanceador de carga).
  • O GKE define o parâmetro de destino da regra de firewall para incluir todos os nós do cluster.
  • Se o Serviço incluir spec.loadBalancerSourceRanges[], o GKE definirá o parâmetro de origem da regra de firewall como os endereços IP dessa lista. Além disso, o GKE configura rotas e regras no sistema operacional do nó para limitar os endereços IP de origem do tráfego com balanceamento de carga, usando kube-proxy e iptables (em clusters que não usam o GKE Dataplane V2) ou regras cilium-agent e eBPF (em clusters com o GKE Dataplane V2). Se o serviço não incluir loadBalancerSourceRanges[], o GKE definirá o parâmetro de origem da regra de firewall como todos os endereços IP (0.0.0.0/0).
  • Para um serviço LoadBalancer IPv6, especifique intervalos CIDR IPv6 no campo spec.loadBalancerSourceRanges[] (por exemplo, o intervalo 2001:db8::/32). O GKE cria uma regra de firewall separada para a regra de encaminhamento IPv6 do Serviço. Se o Serviço não incluir o campo loadBalancerSourceRanges[], o GKE definirá o parâmetro de origem da regra de firewall como todos os endereços IPv6 (::/0).

Endereços IP estáticos

É possível criar um endereço IP estático e configurar o GKE para atribuir esse endereço IP estático à regra de encaminhamento do balanceador de carga. O uso de um endereço IP estático ajuda a garantir que o endereço IP do balanceador de carga permaneça o mesmo, mesmo que você faça alterações no serviço LoadBalancer. Sem um endereço IP estático, o GKE pode atribuir um endereço IP diferente à regra de encaminhamento do balanceador de carga quando você atualiza um serviço LoadBalancer. O endereço IP da regra de encaminhamento não é igual ao endereço spec.clusterIP do Serviço. O endereço ClusterIP de um serviço nunca é alterado quando você atualiza um serviço LoadBalancer.

Parâmetros de endereço IP estático

Para instruir um serviço LoadBalancer a usar um endereço IP estático, use o parâmetro spec.loadBalancerIP ou a anotação networking.gke.io/load-balancer-ip-addresses. Na versão 1.29 e mais recentes do GKE, a anotação terá precedência sobre spec.loadBalancerIP se o manifesto do serviço contiver o parâmetro e a anotação.

Parâmetro ou anotação e valor Requisitos e capacidades
spec.loadBalancerIP:
IPv4_ADDRESS

É possível especificar um endereço IPv4 interno estático para um serviço LoadBalancer interno somente IPv4. É possível especificar um endereço IPv4 externo estático para um serviço LoadBalancer externo somente IPv4. O parâmetro funciona com todas as versões compatíveis do GKE.

networking.gke.io/load-balancer-ip-addresses:
IP_ADDRESS_RESOURCE_NAME
  • Para serviços LoadBalancer de pilha única, defina o valor da anotação como o nome do recurso de endereço IPv4 ou IPv6, não o próprio endereço IP.
  • Para serviços LoadBalancer de pilha dupla, defina o valor da anotação como o nome do recurso de endereço IPv4 estático e o nome do recurso do intervalo de endereços IPv6 estático, separados por uma vírgula.

É possível especificar um endereço IPv4 estático, um intervalo de endereços IPv6 estático ou ambos para serviços LoadBalancer somente IPv4, somente IPv6 e de pilha dupla interna e externa. A anotação requer o GKE 1.29 ou mais recente e os seguintes requisitos extras:

  • Para usar essa anotação com um serviço LoadBalancer interno, o cluster precisa ter a subconfiguração do GKE ativada. A criação de subconjuntos do GKE é ativada por padrão na versão 1.36 e mais recentes do GKE.
  • Para usar essa anotação com um serviço LoadBalancer externo, é preciso definir o campo spec.loadBalancerClass como o valor networking.gke.io/l4-regional-external no manifesto do serviço ao criar o serviço LoadBalancer externo.
  • Para um serviço LoadBalancer externo IPv6 de pilha única no GKE versão 1.37.1-gke.2097000 e posterior, também é possível reservar o intervalo de endereços IPv6 estático de um prefixo público delegado BYOIPv6 regional no modo EXTERNAL_IPV6_FORWARDING_RULE_CREATION.
  • Para um serviço LoadBalancer interno, é possível reservar o intervalo de endereços IPv6 estático de uma sub-rede interna provisionada de um prefixo público delegado BYOIPv6 no modo INTERNAL_IPV6_SUBNETWORK_CREATION.

Considerações para compartilhar um endereço IP comum

Dois ou mais serviços LoadBalancer podem fazer referência ao mesmo endereço IP estático se a regra de encaminhamento de cada balanceador de carga usar uma combinação exclusiva de endereço IP, protocolo, especificação de porta e especificação dos Níveis de serviço de rede, conforme indicado na tabela desta seção. Além disso:

  • Os endereços IPv6 estáticos são, na verdade, intervalos de endereços IPv6 /96, mas o GKE só configura nós para aceitar pacotes no primeiro endereço IPv6 (/128) no intervalo /96.

  • Para que dois ou mais Serviços LoadBalancer internos usem o mesmo endereço IPv4 interno, o endereço IP estático precisa ser criado com a finalidade SHARED_LOADBALANCER_VIP.

Serviço LoadBalancer interno Serviço LoadBalancer externo
Especificação da porta

As regras de encaminhamento para os balanceadores de carga de rede de passagem interna aceitam até cinco números de porta individuais ou podem ser configuradas para usar todas as portas.

Quando um Serviço LoadBalancer interno tem mais de cinco spec.ports[] especificados, o GKE configura a regra de encaminhamento para que o balanceador de carga de rede de passagem interno use todas as portas.

Regras de encaminhamento com o mesmo endereço IP e protocolo não podem ter portas sobrepostas. Isso significa que não é possível criar vários serviços de LoadBalancer interno que compartilhem o mesmo endereço IP, protocolo e portas. Exemplo:

  • Se você criar um serviço LoadBalancer interno usando a porta TCP 80, não será possível criar outro serviço usando as portas TCP 80, 81 e 90 porque a porta 80 se sobrepõe.
  • Se um serviço LoadBalancer interno usar as portas TCP 80, 8080 e 90, não será possível criar outro serviço usando TCP em todas as portas, porque isso também resultaria em portas sobrepostas.

Para mais informações, consulte: Regras de encaminhamento do balanceador de carga de rede de passagem interna que usam um endereço IP comum.

Para clusters que executam versões do GKE anteriores à 1.37, o GKE cria um balanceador de carga de rede de passagem externa regional baseado em pool de destino se o manifesto do serviço LoadBalancer não tiver o campo spec.loadBalancerClass definido como o valor networking.gke.io/l4-regional-external ou não incluir a anotação cloud.google.com/l4-rbs: "enabled". Para clusters que executam o GKE 1.37 ou posterior, é necessário definir explicitamente spec.loadBalancerClass: "networking.gke.io/l4-regional-external-legacy" para criar um balanceador de carga de rede de passagem externa regional baseado em pool de destino.

As regras de encaminhamento para balanceadores de carga de rede de passagem externa regional baseados em pool de destino precisam usar intervalos de portas contíguos. O intervalo de portas contíguas inclui todas as portas de que o serviço precisa, mas também pode incluir outras portas que não são usadas por ele. Por exemplo, um serviço LoadBalancer externo com tecnologia de um balanceador de carga de rede de passagem externa regional baseado em pool de destino, que especifica as portas 80 e 443 no manifesto de serviço, usa uma regra de encaminhamento do balanceador de carga com um intervalo de portas de 80-443. Esse intervalo de portas impede que outros serviços LoadBalancer externos usem qualquer uma das portas 80, 443 e qualquer um dos números entre 80 e 443.

O GKE cria um balanceador de carga de rede de passagem externa regional baseado em serviço de back-end por padrão nas versões 1.37 ou posteriores. Em versões anteriores, o GKE criará o balanceador de carga se o manifesto do serviço LoadBalancer incluir o campo spec.loadBalancerClass definido como o valor networking.gke.io/l4-regional-external. As regras de encaminhamento para balanceadores de carga de rede de passagem externa regionais baseados em serviço de back-end aceitam até cinco números de porta discretos ou um intervalo de portas contíguas.

Níveis de serviço de rede Não configurável: os endereços internos são sempre nível Premium.

Configurável para endereços IPv4 externos estáticos regionais. Os intervalos de endereços IPv6 externos estáticos regionais só podem ser criados no nível Premium.

A especificação dos níveis de serviço de rede do endereço IP externo estático precisa corresponder ao seguinte:

  • O nível especificado na anotação cloud.google.com/network-tier do manifesto do serviço LoadBalancer, se essa anotação estiver presente no manifesto ou
  • O nível padrão do projeto, se a anotação cloud.google.com/network-tier estiver ausente do manifesto do serviço LoadBalancer.

O nível padrão do projeto é Premium, a menos que você o tenha configurado de maneira diferente.

Reserva de endereço IP

O GKE não reserva os endereços IP estáticos configurados usando a anotação spec.loadBalancerIP ou networking.gke.io/load-balancer-ip-addresses. Isso significa que o endereço IP atribuído ao Serviço pode ser liberado quando o Serviço é excluído.

Para manter o endereço IP reservado, crie manualmente um recurso de endereço no projeto. O endereço IP estático precisa ter os seguintes atributos:

  • Ser apenas regional.
  • Estar na mesma região do cluster.
  • Estar nos mesmos Níveis de serviço de rede que o serviço LoadBalancer.
  • Ter um nome que não use o nome do LoadBalancer, prefixos como k8s- ou o UUID do serviço.

Se você não reservar o endereço, os registros do projeto poderão conter entradas sobre recursos de endereço criados e removidos em seguida. Isso faz parte do provisionamento normal de serviços e é esperado.

Sub-rede do LoadBalancer

É possível configurar um serviço LoadBalancer interno para usar um endereço IPv4 temporário ou estático, um intervalo de endereços IPv6 ou ambos em uma sub-rede personalizada localizada na mesma região e rede VPC do cluster. Use uma sub-rede personalizada para um serviço LoadBalancer interno para:

  • Agrupe os balanceadores de carga de rede de passagem interna criados pelos serviços LoadBalancer internos de dois ou mais clusters do GKE na mesma rede VPC e região.
  • Criar serviços LoadBalancer internos com balanceadores de carga de rede de passagem interna que tenham endereços IPv4 separados dos endereços IPv4 do nó do cluster.
  • Criar serviços LoadBalancer internos com balanceadores de carga de rede de passagem interna que tenham intervalos de endereços IPv6 separados do nó do cluster e dos endereços IPv6 do pod. Uma sub-rede LoadBalancer personalizada será obrigatória para oferecer suporte a serviços internos do LoadBalancer se a sub-rede do cluster tiver um intervalo de endereços IPv6 externos.

É possível configurar um serviço LoadBalancer externo para usar um intervalo de endereços IPv6 temporário ou estático em uma sub-rede personalizada localizada na mesma região e rede VPC do cluster. Use uma sub-rede personalizada para criar serviços LoadBalancer externos em que os balanceadores de carga de rede de passagem externa regionais tenham intervalos de endereços IPv6 separados do nó do cluster e dos endereços IPv6 do pod. Uma sub-rede LoadBalancer personalizada será obrigatória para oferecer suporte a serviços LoadBalancer externos se a sub-rede do cluster tiver um intervalo de endereços IPv6 interno.

Os endereços IPv6 para balanceadores de carga de rede de passagem interna e balanceadores de carga de rede de passagem externa regional geralmente vêm de um intervalo de sub-rede na sua rede VPC. Para serviços LoadBalancer externos IPv6 de pilha única no GKE versão 1.37.1-gke.2097000 e posteriores, os endereços IPv6 podem vir de um prefixo público delegado BYOIPv6. Quando o endereço vem de uma sub-rede, o tipo de acesso IPv6 dessa sub-rede precisa corresponder ao tipo de balanceador de carga que você cria: os serviços LoadBalancer internos exigem uma sub-rede com um intervalo de endereços IPv6 interno (incluindo sub-redes provisionadas de um prefixo BYOIPv6), e os serviços LoadBalancer externos exigem uma sub-rede com um intervalo de endereços IPv6 externo. Para um resumo de quando uma sub-rede personalizada do LoadBalancer é necessária, consulte Serviços do LoadBalancer IPv6.

Anotação de sub-rede personalizada

Use a anotação networking.gke.io/load-balancer-subnet: SUBNET_RESOURCE_NAME para instruir um serviço LoadBalancer a usar um endereço IP temporário ou endereço IP estático em uma sub-rede personalizada, em que SUBNET_RESOURCE_NAME é o nome da sub-rede personalizada. É possível usar essa anotação para especificar uma sub-rede personalizada para um serviço LoadBalancer interno somente IPv4, somente IPv6 ou de pilha dupla, ou para um serviço LoadBalancer externo somente IPv6 ou de pilha dupla.

Para usar a anotação networking.gke.io/load-balancer-subnet, é preciso atender aos seguintes requisitos:

  • O cluster precisa executar o GKE versão 1.29 ou posterior.
  • Para especificar uma sub-rede personalizada para um serviço LoadBalancer interno, o cluster precisa ter a criação de subconjuntos do GKE ativada. A criação de subconjuntos do GKE é ativada por padrão nas versões 1.36 e posteriores.
  • Para especificar uma sub-rede personalizada para um serviço LoadBalancer externo, é preciso configurar um balanceador de carga baseado em serviço de back-end. No GKE versão 1.37 e posterior, essa configuração é o comportamento padrão. Em versões anteriores, é preciso incluir o campo spec.loadBalancerClass definido como o valor networking.gke.io/l4-regional-external no manifesto do serviço ao criar o serviço LoadBalancer externo.
  • Para clusters IPv6 de pilha única (criados com a flag --stack-type=ipv6), use essa anotação quando o tipo de acesso do balanceador de carga for diferente do tipo de acesso da sub-rede do nó. Por exemplo, use essa anotação ao implantar um serviço LoadBalancer externo em um cluster em que a sub-rede do nó usa o tipo de acesso IPv6 INTERNAL (ULA) ou ao implantar um serviço LoadBalancer interno em um cluster em que a sub-rede do nó usa o tipo de acesso IPv6 EXTERNAL (GUA). A sub-rede especificada por essa anotação precisa ter um tipo de acesso IPv6 (EXTERNAL ou INTERNAL) que corresponda ao tipo de balanceador de carga associado. Como alternativa, um serviço LoadBalancer externo pode usar o intervalo de endereços IPv6 de um prefixo delegado público BYOIPv6 em vez de uma sub-rede. Nesse caso, não use essa anotação.

Sub-rede e endereço IPv4 de um serviço LoadBalancer interno

A tabela abaixo descreve as combinações válidas de especificação de sub-rede e endereços IPv4 para um serviço LoadBalancer interno somente IPv4 ou de pilha dupla.

Endereço IPv4 estático Endereço IPv4 temporário
Sub-rede personalizada
Sub-rede personalizada e endereço IPv4 estático: o endereço IPv4 interno estático precisa ter sido criado no intervalo de endereços IPv4 principal da sub-rede personalizada. Sub-rede personalizada e endereço IPv4 temporário: o GKE usa um endereço IPv4 interno não alocado no intervalo de endereços IPv4 principal da sub-rede personalizada.
Sub-rede de cluster Sub-rede de cluster e endereço IPv4 estático: o endereço IPv4 interno estático precisa ter sido criado no intervalo de endereços IPv4 principal da sub-rede do cluster. Sub-rede de cluster e endereço IPv4 temporário: o GKE usa um endereço IPv4 interno não alocado no intervalo de endereços IPv4 principal da sub-rede do cluster.

Sub-rede e intervalo de endereços IPv6 para um serviço LoadBalancer interno

A tabela abaixo descreve as combinações válidas de especificação de sub-rede e intervalo de endereços IPv6 para um serviço LoadBalancer interno somente IPv6 ou de pilha dupla. Mesmo que a regra de encaminhamento IPv6 do balanceador de carga de rede de passagem interna use um intervalo de endereços IPv6 /96 interno, o GKE só configura nós para aceitar pacotes com destinos que correspondam ao primeiro endereço IPv6 (/128) do intervalo /96 da regra de encaminhamento.

Intervalo de endereços IPv6 estáticos Intervalo de endereços IPv6 temporário
Sub-rede personalizada de pilha dupla ou somente IPv6
  • Precisa estar na mesma rede VPC e região que o cluster.
  • Precisa ter um intervalo de endereços IPv6 internos (tipo de acesso INTERNAL), que pode ser um intervalo de endereços IPv6 internos fornecido pelo Google ou um intervalo de endereços internos BYOIPv6 provisionado de um prefixo delegado público que está no modo INTERNAL_IPV6_SUBNETWORK_CREATION.
  • Precisa ser especificado usando a anotação networking.gke.io/load-balancer-subnet.
Sub-rede personalizada e intervalo de endereços IPv6 estáticos: o intervalo de endereços IPv6 /96 internos estáticos precisa ter sido criado no intervalo de endereços IPv6 /64 interno da sub-rede personalizada. Sub-rede personalizada e intervalo de endereços IPv6 temporário: o GKE usa um intervalo de endereços IPv6 /96 internos não alocados do intervalo de endereços IPv6 /64 da sub-rede personalizada.
Sub-rede de pilha dupla ou somente IPv6 do cluster
  • Precisa ter um intervalo de endereços IPv6 internos (tipo de acesso INTERNAL), que pode ser um intervalo de endereços IPv6 internos fornecido pelo Google ou um intervalo de endereços internos BYOIPv6.
Sub-rede de cluster e intervalo de endereços IPv6 estáticos: o intervalo de endereços IPv6 /96 internos estáticos precisa ter sido criado no intervalo de endereços IPv6 /64 interno da sub-rede do cluster. Sub-rede de cluster e intervalo de endereços IPv6 temporário: o GKE usa um intervalo de endereços IPv6 /96 interno não alocado do intervalo de endereços IPv6 /64 da sub-rede do cluster.

Sub-rede e endereço IPv4 para um serviço LoadBalancer externo

Para serviços LoadBalancer externos somente IPv4 e de pilha dupla, o endereço IPv4 externo, seja um endereço IPv4 externo estático ou um endereço IPv4 externo temporário, não precisará de uma sub-rede.

Sub-rede e intervalo de endereços IPv6 para um serviço LoadBalancer externo

A tabela a seguir descreve as combinações válidas de sub-rede ou subprefixo e intervalo de endereços IPv6 para um serviço LoadBalancer externo de pilha única IPv6 ou de pilha dupla. Mesmo que a regra de encaminhamento IPv6 do balanceador de carga de rede de passagem externo regional use um intervalo de endereços IPv6 /96 externo, o GKE só configura nós para aceitar pacotes com destinos que correspondam ao primeiro endereço IPv6 (/128) do intervalo /96 da regra de encaminhamento.

Intervalo de endereços IPv6 estáticos Intervalo de endereços IPv6 temporário
Sub-rede personalizada de pilha dupla ou somente IPv6
Sub-rede personalizada e intervalo de endereços IPv6 estáticos: o intervalo de endereços IPv6 /96 externos estáticos precisa ter sido criado no intervalo de endereços IPv6 /64 externo da sub-rede personalizada. Intervalos de endereços IPv6 externos estáticos só podem ser criados no nível Premium. Sub-rede personalizada e intervalo de endereços IPv6 temporário: o GKE usa um intervalo de endereços IPv6 /96 externos não alocados do intervalo de endereços IPv6 /64 externos da sub-rede personalizada.
Sub-rede de pilha dupla ou somente IPv6 do cluster
  • Precisa ter um intervalo de endereços IPv6 externos (tipo de acesso EXTERNAL).
Sub-rede de cluster e intervalo de endereços IPv6 estáticos: o intervalo de endereços IPv6 /96 externos estáticos precisa ter sido criado no intervalo de endereços IPv6 /64 externo da sub-rede do cluster. Intervalos de endereços IPv6 externos estáticos só podem ser criados no nível Premium. Sub-rede de cluster e intervalo de endereços IPv6 temporário: o GKE usa um intervalo de endereços IPv6 /96 externo não alocado do intervalo de endereços IPv6 /64 externo da sub-rede do cluster.
Prefixo delegado público de BYOIPv6
  • Aplica-se apenas aos serviços LoadBalancer externos IPv6 de pilha única na versão 1.37.1-gke.2097000 e posteriores do GKE.
  • O subprefixo regional precisa estar na mesma região do cluster, usar o modo EXTERNAL_IPV6_FORWARDING_RULE_CREATION e ter um comprimento de prefixo alocável de /96.
  • O subprefixo precisa ter o status ANNOUNCED.
  • Funciona em clusters IPv6 de pilha única e em clusters de pilha dupla (o serviço precisa ser IPv6 de pilha única). A sub-rede do cluster pode ter um intervalo de endereços IPv6 interno ou externo (tipo de acesso INTERNAL ou EXTERNAL). Nenhuma sub-rede IPv6 externa é necessária porque o intervalo de endereços vem do subprefixo.
  • Requer um balanceador de carga de rede de passagem externa regional baseado em serviço de back-end (spec.loadBalancerClass: networking.gke.io/l4-regional-external) no nível Premium.
Prefixo BYOIPv6 e intervalo de endereços IPv6 estáticos: é preciso reservar o intervalo de endereços IPv6 /96 externos estáticos do subprefixo regional usando as sinalizações --endpoint-type=NETLB e --ip-collection e referenciar o endereço estático usando a anotação networking.gke.io/load-balancer-ip-addresses. Se quiser, você também pode incluir a anotação networking.gke.io/ip-collection-v6. Se fizer isso, essa anotação precisará fazer referência ao mesmo subprefixo do qual você reservou o endereço estático. Prefixo BYOIPv6 e intervalo de endereços IPv6 temporário: especifique o subprefixo regional usando a anotação networking.gke.io/ip-collection-v6. O GKE aloca um intervalo de endereços IPv6 /96 externo disponível do subprefixo.

Acesso global

Quando a anotação networking.gke.io/internal-load-balancer-allow-global-access é false ou não especificada para um Serviço LoadBalancer interno, o GKE cria um balanceador de carga de rede de passagem interno com regra de encaminhamento que tem o acesso global desativado. Quando o acesso global é desativado, os clientes que precisam acessar o balanceador de carga precisam estar localizados na mesma região e rede VPC ou em uma rede conectada à rede VPC do cluster.

Quando a anotação networking.gke.io/internal-load-balancer-allow-global-access é true para um Serviço LoadBalancer interno, o GKE ativa a opção de acesso global na regra de encaminhamento do balanceador de carga de rede de passagem interno. Os clientes localizados em qualquer região da rede VPC ou em uma rede conectada à rede VPC do cluster podem acessar o balanceador de carga.

Para mais informações sobre como o acesso global se aplica a clientes em uma rede conectada, consulte:

Todas as regras de encaminhamento de portas

As regras de encaminhamento para balanceadores de carga de rede de passagem interna aceitam cinco números de porta exclusivos ou todas as portas.

No GKE, um serviço LoadBalancer interno só pode aceitar até 100 portas no spec.ports[].port do serviço. Se um serviço de LoadBalancer interno definir até cinco portas, a regra de encaminhamento vai incluir essas portas específicas. No entanto, se o Serviço especificar mais de cinco portas, a regra de encaminhamento será configurada automaticamente para corresponder a todas as portas. Ao configurar uma regra de encaminhamento para usar todas as portas, o GKE cria apenas regras de firewall de permissão de entrada para as portas específicas configuradas em spec.ports[].port no Serviço.

Para mais informações sobre as regras de encaminhamento do balanceador de carga de rede de passagem interno e as especificações de porta válidas, consulte Regras de encaminhamento e especificações de porta.

Serviço LoadBalancer de pilha dupla IPv4/IPv6

É possível criar um serviço LoadBalancer interno ou externo que pode ser de pilha única (somente IPv4 ou IPv6) ou de pilha dupla. Os serviços LoadBalancer de pilha única criam uma única regra de encaminhamento com um endereço IPv4 ou um endereço IPv6. Os serviços LoadBalancer de pilha dupla criam duas regras de encaminhamento: uma com um endereço IPv4 e outra com um endereço IPv6. Para criar um serviço LoadBalancer de pilha dupla IPv4/IPv6, implante-o em um cluster de pilha dupla IPv4/IPv6 e conclua qualquer uma das seguintes opções, dependendo do tipo de balanceador de carga usado:

Para cada serviço, é possível definir as especificações ipFamilyPolicy e ipFamilies. Para saber mais, consulte Pilha dupla IPv4/IPv6.

Restrições de serviços LoadBalancer de pilha dupla

  • Os serviços LoadBalancer com endereços IPv6 não são compatíveis com clusters com o tipo de pilha ipv4. Para mais informações, consulte Usar um endereço IP de pilha dupla para um cluster nativo de VPC ou Configurar um cluster IPv6 de pilha única.
  • Não é possível fazer upgrade dos serviços LoadBalancer criados com um endereço de pilha única para serviços de pilha dupla.

  • Os serviços LoadBalancer criados com endereços de pilha dupla podem ser alterados para pilha única de acordo com as seguintes condições:

    • Um serviço com ipFamilies ["IPv4","IPv6"] pode ser alterado para um com ipFamilies IPv4, mas não IPv6.
    • Um serviço com ipFamilies ["IPv6","IPv4"] pode ser alterado para um com ipFamilies IPv6, mas não IPv4.

Serviços LoadBalancer IPv6

Um serviço LoadBalancer IPv6 é um serviço LoadBalancer cuja regra de encaminhamento tem um endereço IPv6. Um Serviço pode ser de pilha única IPv6 ou de pilha dupla com uma regra de encaminhamento IPv4 e uma IPv6. Para criar um serviço LoadBalancer IPv6 de pilha única em um cluster de pilha dupla, defina o valor do campo spec.ipFamilyPolicy como SingleStack e defina o valor do campo spec.ipFamilies como IPv6. Em um cluster somente IPv6, esses são os valores padrão e podem ser omitidos.

Os serviços LoadBalancer IPv6 sempre usam back-ends de NEG GCE_VM_IP, e os endereços IPv6 deles vêm de um intervalo de sub-rede na sua rede VPC ou de um prefixo público delegado de traga seu próprio IPv6 (BYOIPv6).

Os serviços LoadBalancer IPv6 de pilha única estão disponíveis em pré-lançamento no GKE versão 1.36.0-gke.2646000 e mais recentes.

Restrições de serviços LoadBalancer IPv6

  • Não é possível usar o campo spec.loadBalancerIP para especificar um endereço IPv6. Use a anotação networking.gke.io/load-balancer-ip-addresses.
  • Os serviços LoadBalancer IPv6 externos, incluindo intervalos de endereços IPv6 externos estáticos, são compatíveis apenas no nível Premium. O GKE rejeita serviços LoadBalancer IPv6 externos que definem a anotação cloud.google.com/network-tier: Standard.
  • Não é possível alterar um serviço LoadBalancer IPv6 de pilha única para usar um endereço IPv4. Definir o valor do campo spec.ipFamilies como IPv4 ou definir o valor do campo spec.ipFamilyPolicy como RequireDualStack é rejeitado.
  • É possível usar a anotação networking.gke.io/ip-collection-v6 apenas em serviços LoadBalancer externos IPv6 de pilha única no GKE versão 1.37.1-gke.2097000 e posterior. O GKE não é compatível com a anotação networking.gke.io/ip-collection-v6 para serviços de pilha dupla, serviços IPv4 ou serviços internos do LoadBalancer, e não é possível combinar essa anotação com a anotação networking.gke.io/load-balancer-subnet.

Escolher uma sub-rede para o balanceador de carga

O tipo de acesso IPv6 da sub-rede que fornece o endereço IP do balanceador de carga precisa corresponder ao tipo de balanceador de carga. Se a sub-rede do cluster já tiver o tipo de acesso necessário, o GKE vai usar a sub-rede do cluster. Caso contrário, você precisará criar uma sub-rede LoadBalancer personalizada com o tipo de acesso necessário e especificar essa sub-rede com a anotação networking.gke.io/load-balancer-subnet. A única exceção é um serviço LoadBalancer externo que usa um prefixo público delegado BYOIPv6, porque esse prefixo fornece o intervalo de endereços IPv6, independentemente do tipo de acesso da sub-rede do cluster.

A tabela a seguir resume qual sub-rede ou prefixo fornece o intervalo de endereços IPv6 do balanceador de carga:

Tipo de serviço LoadBalancer Tipo de acesso IPv6 da sub-rede do cluster Origem do intervalo de endereços IPv6 do balanceador de carga
Interno INTERNAL A sub-rede do cluster. Nenhuma anotação é necessária.
Interno EXTERNAL Uma sub-rede personalizada do LoadBalancer com um tipo de acesso IPv6 INTERNAL, especificado com a anotação networking.gke.io/load-balancer-subnet.
Interno com BYOIPv6 INTERNAL ou EXTERNAL Uma sub-rede com intervalo de endereços IPv6 interno proveniente de um prefixo público delegado BYOIPv6 no modo INTERNAL_IPV6_SUBNETWORK_CREATION, especificado com a anotação networking.gke.io/load-balancer-subnet (nenhuma anotação será necessária se essa sub-rede for a do cluster).
Externo EXTERNAL A sub-rede do cluster. Nenhuma anotação é necessária.
Externo INTERNAL Uma sub-rede personalizada do LoadBalancer com um tipo de acesso IPv6 EXTERNAL, especificado com a anotação networking.gke.io/load-balancer-subnet.
Externo com BYOIPv6
(GKE 1.37.1-gke.2097000 e posterior)
INTERNAL ou EXTERNAL Um prefixo público delegado BYOIPv6 no modo EXTERNAL_IPV6_FORWARDING_RULE_CREATION, especificado com a anotação networking.gke.io/ip-collection-v6 ou por um endereço IPv6 estático reservado do prefixo. Não especifique a anotação networking.gke.io/load-balancer-subnet.

Para as combinações válidas de sub-rede e intervalo de endereços IPv6, consulte Sub-rede e intervalo de endereços IPv6 para um serviço LoadBalancer interno e Sub-rede e intervalo de endereços IPv6 para um serviço LoadBalancer externo.

Traga seus próprios endereços IPv6 (BYOIPv6)

É possível trazer seus próprios endereços IPv6 (BYOIPv6) com serviços LoadBalancer IPv6 internos e externos.

Para serviços LoadBalancer externos, que alocam endereços diretamente de um prefixo delegado público, o agente de serviço do GKE (service-PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com) requer permissões específicas do Identity and Access Management (IAM). Conceda o papel de Administrador de IP público do Compute (roles/compute.publicIpAdmin) a esse agente no projeto que possui o prefixo delegado público. Esse papel inclui a permissão compute.publicDelegatedPrefixes.use.

O GKE exige essa permissão durante a criação inicial do Serviço e sempre que ele é sincronizado.

Serviços LoadBalancer externos (GKE versão 1.37.1-gke.2097000 e posterior): os serviços LoadBalancer externos IPv6 de pilha única (spec.ipFamilyPolicy: SingleStack e spec.ipFamilies: ["IPv6"]) alocam intervalos de endereços BYOIPv6 externos /96 diretamente de um subprefixo IPv6 regional de um prefixo delegado público (PDP). O GKE é compatível com esse recurso em clusters IPv6 de pilha única e de pilha dupla, desde que o serviço seja IPv6 de pilha única. A sub-rede do cluster pode ter um tipo de acesso IPv6 interno ou externo, porque o intervalo de endereços se origina do subprefixo, não de uma sub-rede.

O subprefixo IPv6 regional precisa atender aos seguintes requisitos:

  • Configurado com o modo EXTERNAL_IPV6_FORWARDING_RULE_CREATION
  • Configurado com um comprimento do prefixo alocável de /96
  • No status ANNOUNCED

Para alocar um intervalo de endereços BYOIPv6 externo temporário, especifique o subprefixo na anotação networking.gke.io/ip-collection-v6 (fornecida como um URL de recurso completo ou o caminho de recurso parcial projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME). Como alternativa, para usar um intervalo de endereços BYOIPv6 externo estático reservado do subprefixo, use a anotação networking.gke.io/load-balancer-ip-addresses.

Se você alterar a anotação networking.gke.io/ip-collection-v6, o GKE vai recriar a regra de encaminhamento IPv6 com um novo endereço do novo prefixo, o que interrompe brevemente o tráfego. Se você remover a anotação, o Serviço vai reverter para um endereço fornecido pelo Google de uma sub-rede com um intervalo de endereços IPv6 externo. Se a sub-rede do cluster usar um intervalo de endereços IPv6 interno, para evitar erros, adicione simultaneamente a anotação networking.gke.io/load-balancer-subnet. Para mais informações, consulte Usar seus próprios endereços IPv6 (BYOIPv6) para um serviço LoadBalancer externo.

Serviços LoadBalancer internos: os serviços LoadBalancer internos IPv6 usam endereços BYOIPv6 de uma sub-rede IPv6 interna. Crie essa sub-rede com base em um subprefixo IPv6 regional de um prefixo delegado público (PDP) configurado no modo INTERNAL_IPV6_SUBNETWORK_CREATION. Saiba mais em Criar e usar subprefixos IPv6.

Para configurar o Serviço, especifique a sub-rede BYOIPv6 usando a anotação networking.gke.io/load-balancer-subnet ou use essa sub-rede como a sub-rede padrão do cluster. Se quiser, especifique um endereço BYOIPv6 interno estático reservado usando a anotação networking.gke.io/load-balancer-ip-addresses.

Os serviços LoadBalancer internos não são compatíveis com a anotação networking.gke.io/ip-collection-v6. Se você aplicar essa anotação, o GKE vai ignorá-la e emitir um evento de aviso IPCollectionV6Error. Para mais informações, consulte Usar seus próprios endereços IPv6 (BYOIPv6) para um serviço LoadBalancer interno.

A seguir