Regras de encaminhamento para o Traffic Director

Este documento se aplica somente ao Traffic Director com as APIs de balanceamento de carga. Recomendamos que você use as APIs de roteamento de serviço ou as APIs de gateway do Google Kubernetes Engine para implantar o Traffic Director.

O Traffic Director usa a regra de encaminhamento para determinar o proxy de destino para o qual o tráfego na malha é roteado.

Cada regra de encaminhamento fornece um único endereço IPv4 global para um serviço. É possível usar esse endereço para criar registros DNS internos para o serviço (por exemplo, usando uma zona particular gerenciada do Cloud DNS). Os filtros de metadados na regra de encaminhamento especificam os critérios para os quais um proxy secundário compatível com xDS recebe a configuração.

Para o plano de controle do Traffic Director, a regra de encaminhamento interna, autogerenciada e global encaminha o tráfego por endereço IP, porta e protocolo para um proxy de destino. O proxy de destino aponta para um mapa de URLs que contém regras que determinam o destino do tráfego. O mapa de URL também especifica o serviço de back-end padrão. Este serviço de back-end especifica uma verificação de integridade e determina o back-end apropriado, como um grupo de instâncias gerenciadas (MIG) que contém instâncias de máquina virtual (VM) ou um grupo de endpoints da rede (NEG) que contém pods de back-end do Google Kubernetes Engine (GKE).

O diagrama a seguir mostra como uma regra de encaminhamento se encaixa na arquitetura do Traffic Director.

Regra de encaminhamento do Traffic Director em destaque.
Regra de encaminhamento do Traffic Director destacada (clique para ampliar)

Propriedades da regra de encaminhamento

Um recurso de regra de encaminhamento contém as seguintes propriedades que se aplicam ao Traffic Director. Essa regra processa o tráfego que corresponde ao endereço IP, protocolo e número de porta do destino.

Um endereço IP 0.0.0.0 em uma regra de encaminhamento é uma das opções ao usar o Traffic Director. Um endereço IP 0.0.0.0 significa qualquer endereço IP.

  • Com uma implantação de proxy, um endereço IP 0.0.0.0 permite que um proxy corresponda a qualquer tráfego de entrada, se nenhuma outra correspondência específica for encontrada.

  • Com uma implantação sem proxy, um endereço IP 0.0.0.0 fornece uma maneira de especificar que um endereço IP não é necessário. Veja mais detalhes sobre o uso de endereços IP 0.0.0.0 com um proxy gRPC de destino.

A tabela a seguir descreve as propriedades da regra de encaminhamento em mais detalhes.

Propriedade Obrigatório Descrição
name ✔

O nome da regra de encaminhamento.

O nome precisa ser exclusivo neste projeto, ter de 1 a 63 caracteres e corresponder à expressão regular: [a-z]([-a-z0-9]*[a-z0-9])?

Isso significa que o primeiro caractere precisa ser uma letra minúscula e os seguintes precisam ser um traço, uma letra minúscula ou um dígito, exceto o último caractere, que não pode ser um traço.
IPAddress ✔

Um dos seguintes: 0.0.0.0 ou 127.0.0.1, ou qualquer endereço RFC 1918.

Os endereços IP para regras de encaminhamento do Traffic Director não precisam corresponder aos intervalos de endereços IP das sub-redes na rede da nuvem privada virtual (VPC). Para uma determinada rede VPC, endereço IP e porta, você pode ter apenas uma regra de encaminhamento interna e autogerenciada.

Por exemplo, na mesma rede VPC, não é possível criar duas regras de encaminhamento que usem o endereço IP 0.0.0.0 e a porta 80.
IPAddress com um proxy gRPC de destino

Uma regra de encaminhamento que referencie um proxy gRPC de destino com o campo validateForProxyless definido como TRUE e seu endereço IP definido como 0.0.0.0.

Um cliente gRPC que usa o esquema xds não realiza uma busca DNS para resolver o nome do host no URI do canal. Em vez disso, esse cliente resolve o hostname[:port] no URI de destino enviando uma solicitação do serviço de descoberta de listener (LDS) para o Traffic Director. Não há busca de DNS envolvida, e uma entrada DNS do nome do host não é necessária.

Como resultado, o Traffic Director usa o endereço IP 0.0.0.0 e a porta (padrão 80) especificada no URI para procurar a regra de encaminhamento. Em seguida, o Traffic Director procura uma regra de host correspondente no mapa de URL do proxy de destino referenciado pela regra de encaminhamento.
target ✔

O proxy de destino para o qual esta regra de encaminhamento direciona o tráfego. O Traffic Director é compatível com target-http-proxy, target-https-proxy e target-grpc-proxy.

When you use the Google Cloud console to configure the forwarding rule, the target proxy is configured automatically. When you use the Google Cloud CLI or the API, the target proxy must exist before you create your forwarding rule. You can use more than one forwarding rule with a given proxy.
IPProtocol ✔ O tipo de protocolo correspondente a essa regra de encaminhamento. O único valor aceito é TCP.
loadBalancingScheme ✔ Especifica como a regra de encaminhamento é usada. O valor válido para o Traffic Director é INTERNAL_SELF_MANAGED.
portRange ✔

Uma porta ou um intervalo de portas mesclado por um traço.

Os pacotes do protocolo especificado enviados para essas portas são encaminhados ao back-end apropriado. É possível especificar um único número de um intervalo, por exemplo, 80 ou 80-8080.

Para uma determinada rede VPC, endereço IP e porta, você pode ter apenas uma regra de encaminhamento interna e autogerenciada. Por exemplo, na mesma rede VPC, não é possível criar duas regras de encaminhamento que usem o endereço IP 0.0.0.0 e a porta 80.

Nos serviços do gRPC sem proxy, a porta na regra de encaminhamento é correspondida à porta especificada no URI que um aplicativo gRPC usa para se conectar a um serviço. Se uma porta não for especificada no URI, 80 será a porta padrão.
network ✔

Especifica a rede VPC em que as VMs do Goole Cloud que executam proxies do Envoy estão localizadas.

Os proxies Envoy leem a configuração do Traffic Director definida para a mesma rede em que os proxies são implantados. É possível usar a rede VPC denominada default ou uma rede personalizada.

O Traffic Director é compatível com balanceamento de carga para clientes somente na rede do Google Cloud. Especifique o nome da rede na regra de encaminhamento. O peering da rede VPC não é compatível.

Adicionar uma regra de encaminhamento global

Para saber como configurar uma regra de encaminhamento na configuração geral do Traffic Director, consulte o seguinte:

A seguir