Todos os produtos
Search
Central de documentação

Serverless App Engine:Criar e gerenciar uma rota para um aplicativo (MSE)

Última atualização: Jun 28, 2026

Configure o roteamento de gateway do seu aplicativo para distribuir requisições a outros serviços ou aplicativos. Um gateway nativo da nuvem do Microservices Engine (MSE) gerencia as regras de roteamento.

Informações básicas

Os gateways nativos da nuvem do MSE são compatíveis com Kubernetes Ingresses, oferecem suporte à descoberta de serviços a partir de fontes como Container Service for Kubernetes (ACK) e Nacos, além de fornecer diversos recursos de segurança e O&M.

Pré-requisitos

Criar uma regra de roteamento

  1. Em SAE Gateway Routing, selecione a região e o namespace de destino no topo da página e clique em Create Gateway Route.

  2. Na página Create Route, configure os parâmetros e clique em Save.

    Item de configuração

    Descrição

    Route Name

    Nome personalizado para a regra de roteamento.

    Network Type

    Tipo de rede para encaminhamento de requisições.

    • Internet: Há cobrança pelo tráfego encaminhado por um gateway voltado para a Internet.

    • Private Network: Não há cobrança pelo tráfego encaminhado por um gateway interno, pois o tráfego permanece dentro da VPC.

    Gateway Type

    Selecione MSE Cloud-native Gateway.

    Gateway Instance

    Parâmetro obrigatório se Gateway Type estiver definido como MSE Cloud-native Gateway. Selecione uma instância de gateway na mesma região e VPC do namespace. Para criar uma instância de gateway, clique em Create MSE Cloud-native Gateway. Para mais informações, consulte Criar um gateway nativo da nuvem do MSE.

    Domain Name

    Selecione um ou mais nomes de domínio para correspondência. Para criar um nome de domínio, clique em Create Domain Name. Para mais informações, consulte Criar um nome de domínio.

    Path

    Caminho da requisição usado para corresponder a requisições HTTP.

    • Se várias regras tiverem o mesmo tipo de correspondência, a regra com o caminho mais longo terá maior prioridade.

    • Se várias regras tiverem tipos de correspondência diferentes, a prioridade será Equal To > Prefix > Regular Expression Match.

      • Equal To: correspondência exata. Por exemplo, o caminho é igual a /user.

      • Prefix: correspondência baseada em prefixo. Por exemplo, o caminho começa com /user.

      • Regular Expression Match: correspondência baseada em expressão regular. Por exemplo, a classe de caracteres é user.

    Method

    Método HTTP usado para corresponder a requisições. Se deixado em branco, todos os métodos serão correspondidos. É possível selecionar vários métodos.

    Header

    Cabeçalho HTTP usado para corresponder a requisições. Se várias regras compartilharem o mesmo tipo de correspondência, a regra com mais parâmetros de cabeçalho terá prioridade.

    Query

    Parâmetro de string de consulta usado para corresponder a requisições HTTP. Se várias regras compartilharem o mesmo tipo de correspondência, a regra com mais parâmetros de consulta terá prioridade.

    Service Source

    Dois tipos de registros têm suporte: SAE Built-in Nacos e MSE Nacos.

    • SAE Built-in Nacos: o SAE modifica automaticamente os endereços do registro e do centro de configuração do programa ao injetar variáveis de ambiente relacionadas e usar um agente Java para modificar bytecode.

    • MSE Nacos: Ao selecionar esta opção, defina MSE Nacos Instance e Namespace of MSE Nacos Instance.

    Nota

    A origem do serviço deve ser igual ao método de descoberta de serviço do aplicativo.

    Scenario

    Tipo de serviço de destino para a rota.

    • Cenário básico

      Single Service: As requisições são distribuídas para um único serviço de back-end. Este é o cenário mais comum.

    • Cenário de lançamento canário

      • By Percentage (Multi-service): As requisições são distribuídas para vários serviços de back-end com base em porcentagens específicas. Frequentemente utilizado em cenários de deslocamento de tráfego e lançamento canário.

      • Tag (Tag-based Routing): As requisições são distribuídas para vários serviços de back-end com base no conteúdo ou em porcentagens específicas. Para implementar o recurso de lançamento canário de ponta a ponta, use este recurso em conjunto com a administração de serviços.

    Para mais informações sobre os tipos de serviços de destino, consulte Visão geral dos métodos de roteamento.

    Backend Services

    Aplicativo, serviço e porta de back-end a serem associados à rota.

    Nota
    • A soma dos pesos de tráfego dos serviços de destino deve ser 100%.

    • O roteamento baseado em tags entra em vigor apenas no primeiro salto do gateway para o serviço de back-end. Para implementar o lançamento canário em todo o link de requisição, utilize este recurso em conjunto com o recurso de lançamento canário de ponta a ponta.

    Timeout (Seconds)

    Período de tempo limite em segundos. Valor padrão: 60. Um valor igual a 0 significa que a requisição nunca expira.

    Advanced Settings

    Fallback

    Ative Fallback e selecione um serviço de fallback. Se nenhum nó estiver disponível para o serviço de back-end apontado pela rota, as requisições serão encaminhadas para o serviço de fallback especificado.

    Nota

    Atualmente, o recurso de fallback tem suporte apenas entre serviços HTTP.

    Após criar a regra de roteamento, visualize, edite e gerencie a regra na página Gateway Routing.

Gerenciar uma regra de roteamento

Depois de criar uma regra de roteamento, visualize sua configuração de encaminhamento de tráfego, ou edite e exclua a regra na página Gateway Routing.