Regras de encaminhamento para o Cloud Service Mesh

Observação: este guia só oferece suporte ao Cloud Service Mesh com APIs do Google Cloud e não às APIs do Istio. Para mais informações, consulte Visão geral do Cloud Service Mesh.

Este documento se aplica apenas ao Cloud Service Mesh com as APIs de balanceamento de carga. Recomendamos que você use as APIs de roteamento de serviço para implantar o Cloud Service Mesh.

O Cloud Service Mesh 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.

Observação: nesta página, são abordadas apenas as regras de encaminhamento no contexto da Cloud Service Mesh. As regras de encaminhamento também são usadas para fornecer informações de encaminhamento no plano de controle para encaminhamento de protocolos, gateways de VPN clássica e Balanceadores de carga do Google Cloud. Para uma visão geral mais abrangente das regras de encaminhamento, consulte a visão geral das regras de encaminhamento do Cloud Load Balancing.

Para o plano de controle do Cloud Service Mesh, 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 da malha de serviços do Cloud.

Regra de encaminhamento da Cloud Service Mesh destacada (clique para ampliar)

Propriedades da regra de encaminhamento

Um recurso de regra de encaminhamento contém as seguintes propriedades que se aplicam ao Cloud Service Mesh. 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 Cloud Service Mesh. 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 das regras de encaminhamento da Cloud Service Mesh não precisam corresponder aos intervalos de endereços IP das sub-redes na rede de 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 serviço de descoberta de listener (LDS) para o Cloud Service Mesh. Não há busca de DNS envolvida, e uma entrada DNS do nome do host não é necessária. Como resultado, o Cloud Service Mesh 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 Cloud Service Mesh 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 Cloud Service Mesh oferece suporte a target-http-proxy, target-https-proxy e target-grpc-proxy. Quando você usa o Console do Google Cloud para configurar a regra de encaminhamento, o proxy de destino é configurado automaticamente. Quando você usa a CLI do Google Cloud ou a API, o proxy de destino precisa existir antes de criar sua regra de encaminhamento. É possível usar mais de uma regra de encaminhamento com um determinado 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 Cloud Service Mesh é 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 Cloud Service Mesh definida para a mesma rede em que os proxies são implantados. É possível usar a rede VPC denominada default ou uma rede personalizada. A Cloud Service Mesh é compatível com o 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 Cloud Service Mesh com as APIs de balanceamento de carga, consulte:

• Configurar o Cloud Service Mesh para VMs do Compute Engine com implantação automática do Envoy
• Configurar o Cloud Service Mesh para VMs do Compute Engine com implantação manual do Envoy
• Configurar a Mesh de serviços do Cloud para pods do GKE com a injeção automática do Envoy
• Configurar a Cloud Service Mesh para pods do GKE com injeção manual do Envoy
• Configurar a malha de serviços da Cloud para VMs do Compute Engine e serviços gRPC sem proxy
• Configurar a malha de serviço do Cloud para pods do GKE e serviços gRPC sem proxy

A seguir

• Para usar filtros de metadados para controlar quais proxies de arquivo secundário recebem a configuração anexada à regra de encaminhamento, consulte Como configurar o filtro de configuração com base na correspondência MetadataFilter.
• Para rotear o tráfego, consulte Visão geral dos mapas de regras de roteamento do Cloud Service Mesh.
• Para saber mais sobre o Cloud Service Mesh, consulte a Visão geral do Cloud Service Mesh.