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 |
Instrui o GKE a criar um balanceador de carga de rede de passagem interna. O balanceador de carga usará back-ends de NEG
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. |
Recomendamos |
||
| Balanceador de carga de rede de passagem externa regional baseado em serviço de back-end |
Instrui o GKE a criar um balanceador de carga de rede de passagem externa regional. O balanceador de carga usará back-ends de NEG
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. |
Recomendamos |
||
| 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 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 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 |
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 |
Todas as versões compatíveis | ||
| Endereços IP estáticos |
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. |
|
||
| 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 |
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 Para serviços LoadBalancer internos, configure o BYOIPv6 especificando uma
sub-rede interna BYOIPv6 com a
anotação |
(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 |
GKE versão 1.18.19-gke.1400 ou posterior | ||
| ipFamilyPolicy |
Define como o GKE aloca endereços IP para um serviço.
Defina Para criar um serviço LoadBalancer IPv6 de pilha única em um cluster de pilha dupla, defina o valor desse campo como |
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) |
Define a família de endereços IPs para alocar serviços de pilha única ou de pilha dupla. Use um dos seguintes valores:
Para um serviço LoadBalancer IPv6 de pilha única em um cluster de pilha dupla, defina o valor desse campo como |
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 |
Local |
É possível selecionar uma porta personalizada usando o
|
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, usandokube-proxyeiptables(em clusters que não usam o GKE Dataplane V2) ou regrascilium-agente eBPF (em clusters com o GKE Dataplane V2). Se o serviço não incluirloadBalancerSourceRanges[], 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 intervalo2001: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 campoloadBalancerSourceRanges[], 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
|
É 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:
|
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 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:
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 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 |
| 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 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.loadBalancerClassdefinido como o valornetworking.gke.io/l4-regional-externalno 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 IPv6INTERNAL(ULA) ou ao implantar um serviço LoadBalancer interno em um cluster em que a sub-rede do nó usa o tipo de acesso IPv6EXTERNAL(GUA). A sub-rede especificada por essa anotação precisa ter um tipo de acesso IPv6 (EXTERNALouINTERNAL) 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
|
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
|
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
|
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
|
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:
- Acesso do cliente na documentação do balanceador de carga de rede de passagem
- Balanceadores de carga de rede de passagem interna e redes conectadas
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 os serviços LoadBalancer internos, é necessário ativar a criação de subconjuntos do GKE. A criação de subconjuntos do GKE é ativada por padrão para clusters IPv6 de pilha única e de pilha dupla. Para mais informações, consulte Como ativar a criação de subconjuntos do balanceador de carga interno.
- Para serviços LoadBalancer externos, use um balanceador de carga de rede de passagem externa regional baseado em serviço de back-end. Para mais informações, consulte Balanceador de carga de rede externo baseado em serviço de back-end.
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 ipFamiliesIPv4, mas nãoIPv6. - Um serviço com ipFamilies
["IPv6","IPv4"]pode ser alterado para um com ipFamiliesIPv6, mas nãoIPv4.
- Um serviço com ipFamilies
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.loadBalancerIPpara especificar um endereço IPv6. Use a anotaçãonetworking.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.ipFamiliescomoIPv4ou definir o valor do campospec.ipFamilyPolicycomoRequireDualStacké rejeitado. - É possível usar a anotação
networking.gke.io/ip-collection-v6apenas 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çãonetworking.gke.io/ip-collection-v6para 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çãonetworking.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
- Saiba mais sobre os serviços LoadBalancer.
- Saiba como configurar um balanceador de carga interno.
- Leia uma visão geral da Entrada para balanceadores de carga de aplicativo.
- Saiba como usar NEGs independentes.
- Saiba mais sobre as regras de firewall da VPC.