Todos os produtos
Search
Central de documentação

Serverless App Engine:Configurar início e encerramento graceful

Última atualização: Jun 28, 2026

Aplicações podem ficar temporariamente indisponíveis durante operações como dimensionamento de instâncias, rollbacks, atualizações, inícios ou paradas. O Serverless App Engine (SAE) integra o recurso de início e encerramento graceful do Microservices Engine (MSE). Esse recurso utiliza capacidades como prefetch de serviço e registro atrasado para garantir a continuidade dos negócios.

Informações básicas

  • Início graceful:

    Aplicações são frequentemente publicadas, dimensionadas ou reiniciadas. O recurso de início graceful protege as aplicações durante essas operações. Um serviço provedor pode ser chamado por um consumidor assim que é registrado em um registry. No entanto, o provedor ainda pode precisar executar tarefas de inicialização, como configurar um pool de conexões de banco de dados. Recomenda-se o uso do início graceful para aplicações de microsserviços com alto tráfego.

  • Encerramento graceful:

    Ao atualizar uma aplicação online, mantenha a continuidade do serviço enquanto a aplicação para e reinicia. Em cenários de alta concorrência, desligar diretamente uma instância provedora de serviço pode causar problemas. A instância consumidora do serviço não consegue detectar o status em tempo real da instância downstream e continua encaminhando requisições para a instância offline, o que gera erros de requisição e perda de tráfego. Para garantir que sua aplicação seja encerrada corretamente durante operações como deploy, parada, rollback, scale-in ou redefinição, configure o recurso de encerramento graceful.

Pré-requisitos

Acessar a página do recurso

  1. Na lista de aplicações do SAE, selecione a região e o namespace de destino e clique em Application ID desejado para acessar a página de detalhes da aplicação.

  2. No painel de navegação à esquerda, escolha Microservices Governance > Traffic Governance. Em seguida, clique em aba Graceful Start and Shutdown.

Configurar início e encerramento graceful

  1. Na página Graceful Start and Shutdown, defina as configurações.

    Importante
    • Para usar este recurso pela primeira vez, clique em Enable Microservices Governance e em Refresh na página para acessar as definições de configuração.

    • O processo de ativação leva cerca de 1 a 2 minutos. Aguarde a conclusão.

    Início graceful

    Na seção Graceful Start, ative a chave e configure os seguintes parâmetros.

    Item de configuração

    Descrição

    Delayed Registration Duration (Second)

    Define o atraso para o registro de serviço. Este parâmetro adia o registro do serviço por uma duração especificada. Se sua aplicação possui um processo de carregamento assíncrono de recursos de longa execução na inicialização, utilize este parâmetro para ajustar o comportamento de registro de novos nós e adiar o momento em que começam a receber requisições de chamada.

    Importante

    Se a duração do registro atrasado não for 0, configure readiness (sonda de prontidão) durante a implantação da aplicação. Defina o caminho de acesso como /health e a porta como 54199. (Após ativar a administração de microsserviços, o agente escuta automaticamente na porta 54199. Não é necessário escutar esta porta na sua aplicação.) Isso garante que o Kubernetes considere o serviço no estado pronto somente após o serviço estar totalmente registrado no registry. Tal medida evita uma queda repentina no tráfego de entrada devido à incapacidade do consumidor de serviço de encontrar um provedor ativo. Não defina LivenessProbe (sonda de vivacidade) com o mesmo caminho, /health. Caso contrário, a aplicação pode entrar em um loop infinito de reinicializações. Para etapas detalhadas sobre como configurar a sonda de prontidão para aplicações, consulte Configurar verificação de integridade.

    Low-traffic Prefetching Duration (Seconds)

    Abra as opções avançadas e defina a duração de prefetch para baixo tráfego. O mecanismo de prefetch de tráfego assegura que, ao adicionar um novo nó, o tráfego inicial de chamadas de microsserviços para esse nó seja baixo e aumente gradualmente. Esse design ajuda a mitigar a capacidade reduzida de processamento durante o cold start de uma aplicação Java e previne um aumento significativo no tempo de resposta (RT) geral do sistema. O processo de prefetch termina automaticamente após a duração especificada. Após o término, o nó lida com a quantidade total de tráfego.

    Encerramento graceful

    Após conectar-se ao MSE, o encerramento graceful é ativado por padrão.

    Se você ativar a chave de notificação proativa, um nó que ficará offline notificará ativamente os consumidores sobre seu desligamento. Isso impede que os consumidores chamem o nó offline. Este recurso está desativado por padrão. Contudo, se sua aplicação utiliza o framework Spring Cloud e você notar falhas nas chamadas dos consumidores durante o processo de encerramento, ative este recurso para resolver o problema.

Desativar início e encerramento graceful

  • Início graceful

    No painel de navegação à esquerda da sua aplicação, escolha Microservices Governance > Traffic Governance. Clique em aba Graceful Start And Shutdown. Na seção Graceful Start, desative a chave.

  • Encerramento graceful

    Após conectar-se ao MSE, o encerramento graceful é ativado por padrão e não pode ser desativado separadamente.

Para evitar custos desnecessários com o MSE, acesse a página Basic Information da aplicação alvo, escolha More > Disable Microservices Governance no canto superior direito e desative o recurso conforme solicitado.

Aviso

Após desativar o recurso de governança de microsserviços, outros recursos relacionados (incluindo início e encerramento graceful, regras de canary release, limitação e degradação) não poderão ser usados, exceto o recurso de lista de serviços. A desativação da governança de microsserviços aciona uma reinicialização da aplicação. Avalie os riscos ao negócio antes de desativar esse recurso.