Direcione o tráfego de entrada para seus aplicativos SAE usando um API Gateway nativo da nuvem. Este guia orienta você na criação de uma rota de gateway no console SAE e explica as principais opções de configuração.
Contexto
O API Gateway nativo da nuvem é uma solução unificada que combina gateways de tráfego, microsserviços, segurança e IA em uma única plataforma. Ele gerencia a descoberta de serviços, o balanceamento de carga e a comunicação entre serviços, substituindo a configuração fragmentada dos gateways distribuídos tradicionais. Para obter mais informações, consulte O que é um API gateway nativo da nuvem?.
Pré-requisitos
Antes de começar, verifique se você possui:
MSE: Uma instância do API Gateway nativo da nuvem. Consulte Criar uma instância do API Gateway nativo da nuvem.
SAE: Um namespace na mesma região do gateway, vinculado à mesma Virtual Private Cloud (VPC). Consulte Criar um namespace.
SAE: Um aplicativo implantado nesse namespace.
Criar uma rota de gateway
Acesse a página Roteamento de Gateway SAE, selecione uma região e um namespace e clique em Create Gateway Route.
Na página Create Route, configure os parâmetros a seguir e clique em Save.
Configurações básicas
|
Parâmetro |
Descrição |
Exemplo |
|
Route name |
Nome personalizado para a regra de roteamento. |
|
|
Network type |
Rede usada para encaminhar solicitações. Internet: tráfego da internet pública, cobrado conforme o volume realmente encaminhado. Private: tráfego apenas dentro da VPC atual, sem cobrança. |
Internet |
|
Gateway type |
Selecione Cloud-native API Gateway. |
Cloud-native API Gateway |
|
Gateway instance |
Obrigatório quando Gateway type for Cloud-native API Gateway. Selecione uma instância na mesma região e VPC do namespace. Para criar uma nova instância, clique em Create Cloud-native API Gateway. Consulte Criar uma instância do API Gateway nativo da nuvem. |
|
|
Domain name |
Um ou mais nomes de domínio para correspondência. Para adicionar um novo domínio, clique em Create Domain Name. Consulte Criar um nome de domínio. |
|
Condições de correspondência
Configure como o gateway identifica as solicitações desta rota.
Correspondência de caminho
Defina o padrão de caminho a ser correspondido nas solicitações http.
|
Tipo de correspondência |
Comportamento |
Exemplo |
|
Equals |
Apenas correspondência exata. |
|
|
Prefix |
Corresponde a qualquer caminho iniciado com o valor especificado. |
|
|
Regular expression |
Compara caminhos com um padrão de expressão regular. |
|
Quando várias regras compartilham o mesmo tipo de correspondência, a regra com o caminho mais longo tem prioridade. Entre tipos diferentes, a ordem de prioridade é: Equals > Prefix > Regular expression.
Exemplo de prioridade
A tabela abaixo mostra qual rota o SAE seleciona para solicitações de exemplo:
|
Caminho da solicitação |
Rota selecionada |
Motivo |
|
|
|
A correspondência exata tem a maior prioridade. |
|
|
|
Sem correspondência exata; o prefixo captura a solicitação. |
|
|
|
Sem correspondência exata ou de prefixo; a expressão regular é aplicada. |
Outras condições de correspondência
|
Parâmetro |
Descrição |
Exemplo |
|
Method |
Métodos http para correspondência. Deixe em branco para corresponder a todos os métodos. |
|
|
Request header |
Nome do cabeçalho, tipo de correspondência e valor. Quando múltiplas regras possuem as mesmas condições, prevalece aquela com mais parâmetros de cabeçalho. |
Nome: |
|
Request parameter (Query) |
Chave da string de consulta, tipo de correspondência e valor. Se houver empate nas condições, a regra com mais parâmetros de consulta vence. |
Chave: |
Origem do serviço e backend
Service source
Selecione o registro de serviços compatível com o método de registro do seu aplicativo.
|
Opção |
Quando usar |
|
MSE Nacos |
O aplicativo utiliza o MSE Nacos para registro e descoberta de serviços. Requer a seleção de uma MSE Nacos instance e de um MSE Nacos namespace. |
|
K8s Service |
O aplicativo usa ServiceNames do Kubernetes. Oferece suporte a registro e descoberta de serviços em múltiplas linguagens e atribui nomes de domínio fixos para evitar alterações de endereço IP após a implantação. |
A origem do serviço deve corresponder ao método de registro e descoberta utilizado pelo seu aplicativo.
Cenários e serviço de backend
|
Parâmetro |
Descrição |
Exemplo |
|
Scenarios |
Single service: encaminha todas as solicitações correspondentes para um único backend. Multiple services (canary release): divide o tráfego entre vários backends por peso. Consulte Visão geral dos métodos de roteamento. |
Single service |
|
Backend service |
Aplicativo alvo, nome do serviço, protocolo e porta. Ao utilizar múltiplos serviços, a soma das porcentagens de peso do tráfego deve ser igual a 100%. |
Aplicativo: |
Exemplo de canary release
Em um cenário de canary release (múltiplos serviços), divida o tráfego por porcentagem para validar uma nova versão antes da liberação total:
Versão estável (
demo-v1): 90% do tráfegoVersão canary (
demo-v2): 10% do tráfego
Após confirmar a estabilidade da versão canary, aumente gradualmente a porcentagem até que ela processe 100% do tráfego.
Configuração avançada
|
Parâmetro |
Descrição |
Padrão |
Exemplo |
|
Fallback |
Ative para especificar um serviço de fallback. Caso nenhum nó saudável esteja disponível no backend principal, o gateway encaminha as solicitações para o serviço de fallback. Atualmente suportado apenas entre serviços http. |
Off |
Enabled |
|
Timeout (s) |
Tempo máximo, em segundos, que o gateway aguarda por uma resposta do backend. Defina como |
60 |
|
|
Retries |
Número de tentativas após uma falha na solicitação. Defina como |
— |
|
|
Retry conditions |
Eventos que disparam uma nova tentativa. Consulte Configurar uma política de nova tentativa. |
— |
|
|
Retry status codes |
Códigos de status http que acionam uma nova tentativa. |
— |
|
Gerenciar regras de roteamento
Após criar uma rota, acesse a página Gateway Routing para visualizar, editar ou excluir rotas de gateway.
Próximos passos
Visão geral dos métodos de roteamento — entenda como funcionam os roteamentos de serviço único e de múltiplos serviços.
Configurar uma política de nova tentativa — ajuste o comportamento de novas tentativas para suas rotas.