Todos os produtos
Search
Central de documentação

Serverless App Engine:Configure o acesso à aplicação com um K8s Service

Última atualização: Jul 20, 2026

O SAE oferece suporte ao registro e à descoberta de serviços multilíngues por meio de K8s Services. Configure um nome de domínio fixo para uma aplicação em um cluster SAE para evitar que os endereços IP das instâncias mudem após cada implantação.

Contexto

Em uma arquitetura distribuída de microsserviços, o registro e a descoberta de serviços garantem comunicação confiável entre componentes de servidor e cliente durante a inicialização e a interrupção dos serviços.

  • Registro de serviço: uma instância de serviço registra suas informações em um registro, que os clientes leem e assinam posteriormente.

  • Descoberta de serviço: um cliente consulta o registro para obter os endereços dos serviços dependentes antes de fazer uma solicitação. O registro expõe os endereços das instâncias e metadados por meio de uma interface predefinida.

Limitações

  • Este nome de domínio serve apenas para acessar instâncias na mesma aplicação SAE. Para permitir o acesso de outros serviços, como FC, ACK ou ECS, associe um Classic Load Balancer (CLB) privado ou público. Para mais informações, consulte Configure application service access by using a CLB.

  • Não é possível usar o comando ping para acessar um K8s Service. Em vez disso, utilize TCP ou UDP no seu código. Para verificar a conectividade de rede, use o comando ping para testar o endereço IP do pod da aplicação.

  • Um pod de aplicação não consegue acessar a si mesmo usando seu K8s Service.

  • Caso uma aplicação servidora e uma aplicação cliente precisem se chamar mutuamente, ambas devem ter um K8s Service configurado.

Procedimento

  1. Acesse a página de configuração.

    Durante a criação

    1. Faça login no console do SAE. No painel de navegação à esquerda, escolha Applications > Applications. Selecione uma região e um namespace e clique em Create Application.

    2. Selecione uma versão da aplicação e clique em Create Application.

    3. Na página do assistente Basic Information, defina as configurações e clique em Next: Advanced Settings.

    4. Na página do assistente Advanced Settings, localize e expanda a seção Service Registration and Discovery.

    Durante a implantação

    Aviso

    Após reimplantar uma aplicação, ela será reiniciada. Para evitar erros imprevisíveis, como interrupções nos negócios, recomendamos implantar aplicações fora dos horários de pico.

    1. Faça login no console do SAE. No painel de navegação à esquerda, escolha Applications > Applications. Selecione uma região e um namespace e clique no nome da sua aplicação.

    2. Na página Basic Information da aplicação, clique em Deploy Application.

    3. Na página do assistente Deploy Application, localize e expanda a seção Service Registration and Discovery.

  2. Configure o registro e descoberta de serviços baseados em Kubernetes Service.

    1. Ative a opção Kubernetes Service-based service registration and discovery.

    2. Defina o Service name, a Port e o Protocol.

      Parâmetro

      Descrição

      Nome do serviço

      Insira um nome de serviço personalizado. O nome deve ser exclusivo por conta dentro de uma região e não pode ser alterado após a criação.

      Nota

      Por padrão, o nome da aplicação é usado como nome do serviço.

      Porta

      Insira um número de Port entre 1 e 65535.

      Nota

      É possível adicionar até cinco configurações de porta e protocolo.

      Porta do contêiner

      Insira a porta do contêiner.

      Protocolo

      Selecione um protocolo. Os seguintes protocolos são suportados:

      • TCP

      • UDP

Nomes de domínio de acesso

Na página Basic Information da aplicação desejada, vá até a seção Application Access Settings e visualize as informações na aba Kubernetes Service-based Access.

Nota

Os quatro tipos de nomes de domínio a seguir são suportados:

  • Para acessar aplicações no mesmo namespace, utilize o nome do serviço. Exemplo: demo.

  • Para acessar aplicações entre namespaces diferentes, use um dos seguintes formatos de nome de domínio.

    • demo.nsfoo

      Neste exemplo, nsfoo é um namespace personalizado. Se a aplicação alvo estiver no namespace padrão, use default como nome do namespace. Exemplo: demo.default .
    • demo.nsfoo.svc.cluster.local

    • demo.nsfoo.svc.cluster.local.cn-hangzhou

Exemplo de mapeamento de portas: a porta é 2000, a porta do contêiner é 5000 e o protocolo é TCP.