O Cloud-native API Gateway avalia as regras de roteamento da maior para a menor prioridade. Se uma requisição corresponder a uma regra, o gateway a encaminhará ao serviço de backend configurado. Caso nenhuma regra corresponda, o gateway retornará um erro 404.
Prioridade de correspondência de rotas
Quando há várias regras de roteamento, a priorização segue esta ordem: Associated Domain Name > Path > Header > Query Parameters > Created At.
Associated Domain Name: Strings de domínio mais longas têm maior prioridade.
-
Path:
Se a Match Rule for diferente, a prioridade será: Equals To > Prefix > Regular Expression Match.
Se a Match Rule for igual, valores de Path mais longos terão maior prioridade.
Header: Quanto maior o número de pares chave-valor, maior a prioridade.
Query Parameters: Quanto maior o número de pares chave-valor, maior a prioridade.
Created At: Horários de criação anteriores têm maior prioridade.
Procedimento
-
Crie uma rota fora ou dentro de uma instância de gateway.
Fora de uma instância
Faça login no console do Cloud-native API Gateway. No painel de navegação à esquerda, clique em API e selecione uma região.
Clique na API desejada e selecione a instância de destino ou All Instances na lista suspensa.
Clique em Create Route.
Dentro de uma instância
Faça login no console do Cloud-native API Gateway. No painel de navegação à esquerda, clique em Instance e selecione uma região.
Na página Instance, clique no ID da instância de gateway de destino. No painel de navegação à esquerda, clique em API e selecione a API de destino.
Clique em Create Route.
-
Na página Create Route, configure os parâmetros e clique em Save ou Save and Publish.
NotaAs condições de correspondência usam o operador lógico AND. Adicionar mais condições reduz o escopo de correspondência.
A prioridade da rota segue a ordem de exibição na página de configuração.
Parâmetro
Descrição
Route Name
Nome personalizado da rota.
Route Description
Clique em Add Route Description para adicionar uma descrição à rota.
Domain Name
-
Selecione um ou mais domínios para correspondência.
-
Para adicionar um domínio, clique em Add Domain e siga as instruções na tela.
Path
Caminho da requisição para correspondência.
-
Com a mesma regra de correspondência, caminhos mais longos têm maior prioridade.
-
Com regras de correspondência diferentes, a prioridade será: Equals To > Prefix > Regular Expression Match.
-
Equals To: Corresponde ao caminho exato, como
/user. -
Prefix: Corresponde a um prefixo de caminho, como caminhos iniciados com
/user. -
Regular Expression Match: Corresponde a um padrão de expressão regular.
-
Method
Método HTTP para correspondência. Selecione vários métodos se necessário. Padrão: ANY.
Header
Headers da requisição para correspondência.
Query Parameters
Parâmetros de consulta para correspondência.
Instance
Instância de gateway desta rota.
Scenario
Tipo de serviço de backend da rota.
-
Cenário básico: Single Service
-
Cenário de canary release: By Percentage (Multi-service), Tag (Tag-based Routing)
-
Outros cenários: Mock, Redirect
Os tipos de serviço de backend estão descritos em Rotas.
NotaA soma dos pesos de tráfego de todos os serviços de backend deve totalizar 100%.
Backend Services
Serviço de backend e porta para os quais esta rota encaminha requisições.
Nota-
Clique em Associated Service para selecionar uma source e um serviço.
-
O número máximo de sources depende do tipo de source.
-
Container Service: até 5 sources.
-
Nacos e Zookeeper: apenas 1 source.
-
Timeout Period (seconds)
Tempo limite da requisição em segundos. Padrão: 60. Defina como 0 para desativar o tempo limite.
Fallback
Serviço receptor de requisições quando o backend primário não tem nós disponíveis.
NotaO Fallback é compatível apenas com serviços HTTP.
Retry Times
Número de novas tentativas. Padrão: 2. Defina como 0 para desativar novas tentativas.
Retry Condition
Condições que acionam uma nova tentativa.
Retry Status Code
Códigos de status que acionam uma nova tentativa.