Microservices Engine:Proteção contra lista vazia

Limites

O cliente Java do Nacos na versão 1.4.1 ou posterior oferece suporte à proteção contra lista vazia.

Procedimento

• Se você utilizar o cliente Java do Nacos, execute as seguintes operações:

  1. Adicione a seguinte dependência do Nacos client:

     <!-- ${nacos-client.version} must be 1.4.1 or later. -->
     <dependency>
         <groupId>com.alibaba.nacos</groupId>
         <artifactId>nacos-client</artifactId>
         <version>${nacos-client.version}</version>
     </dependency>

  2. Defina as seguintes configurações no código da aplicação:

     Properties properties = new Properties();
     properties.put(PropertyKeyConst.SERVER_ADDR, "${Endpoint of the MSE Nacos instance}");
     properties.put(PropertyKeyConst.NAMING_PUSH_EMPTY_PROTECTION, "true");
     NamingService naming = NamingFactory.createNamingService(properties);

• Se sua aplicação for Spring Cloud Alibaba, adicione a seguinte configuração ao arquivo de configuração da aplicação:

  spring.cloud.nacos.discovery.namingPushEmptyProtection=true

• Se sua aplicação for Dubbo, inclua a seguinte configuração de URL de registro no arquivo de configuração da aplicação Dubbo:

  dubbo.registry.address=nacos://${Endpoint of the MSE Nacos instance}:8848?namingPushEmptyProtection=true

Limites

A versão do mecanismo Nacos deve ser 2.1.0.0 ou posterior. Para mais detalhes sobre como atualizar a versão do mecanismo Nacos, consulte Atualizar uma versão do Nacos.

Procedimento

O método para ativar a proteção contra lista vazia varia conforme a versão do seu mecanismo MSE Nacos.

• Nas versões 2.1.0.0 ou 2.1.0.1 do mecanismo MSE Nacos, nenhuma ação é necessária, pois a proteção contra lista vazia já vem ativada automaticamente.

• Se a versão do seu mecanismo MSE Nacos for 2.1.0.2 ou posterior, siga os passos abaixo para ativar a proteção contra lista vazia:

  1. Faça login no console do MSE e selecione uma região na barra de navegação superior.

  2. No painel de navegação à esquerda, escolha Microservices Registry > Instances.

  3. Na página Instances, clique em nome da instância.

  4. No painel de navegação à esquerda, clique em Parameter Settings. Na seção Real-time Effective Parameters da página Parameter Settings, clique em Edit na coluna Actions correspondente ao parâmetro forcePushEmptyProtectionForAllService.

  5. Na caixa de diálogo Edit Parameters, selecione Yes para Value e clique em OK.

     Nota

     Para garantir a máxima disponibilidade do serviço, recomendamos sempre selecionar Yes no campo Value do parâmetro forcePushEmptyProtectionForAllService.

Verificar o resultado

Quando um serviço aciona a proteção contra lista vazia, a mensagem Trigger push empty protection for Service aparece no arquivo naming.log, localizado no diretório ${user.home}/logs/nacos do nó onde reside o consumidor.

Em situações normais, essa informação não aparece com frequência. Se ela aparecer frequentemente, investigue as possíveis causas abaixo:

• Os provedores assinados pelo consumidor não existem.

  Se o consumidor assinar um provedor inexistente, verifique se a dependência da aplicação é realmente necessária. Caso não seja, remova a dependência inválida. Se for indispensável, publique o provedor novamente.

• Nenhum provedor aparece na lista de instâncias.

  • Verifique se há desconexões frequentes dos provedores assinados pelo consumidor.

  • Confirme se a conexão de rede entre cada provedor e a instância MSE Nacos está normal. Conexões anormais fazem com que a instância MSE Nacos considere o provedor como desconectado.

Identificar o serviço que acionou a proteção contra lista vazia

A mensagem de erro contém informações sobre o serviço responsável por acionar a proteção. É possível identificar o serviço vazio assinado pelo consumidor por meio do trecho Service{namespace='XXX', group='xx', name='xxxxxxx', ephemeral=true, revision=0}.

Cenários conhecidos de acionamento

Cenários com ativação forçada da proteção contra lista vazia

A partir do MSE Nacos 2.1.0.2, a lógica de ativação da proteção contra lista vazia foi otimizada. Essa melhoria garante que a proteção só seja ativada quando se seleciona Yes no campo Value do parâmetro forcePushEmptyProtectionForAllService. No entanto, para preservar a disponibilidade e estabilidade, o sistema ainda ativa automaticamente a proteção nos cenários abaixo, mesmo que se tenha escolhido No no campo Value do parâmetro forcePushEmptyProtectionForAllService.

• Durante atualizações, reinicializações ou recuperações de falhas em nós do mecanismo, uma proteção contra lista vazia de dois minutos é ativada automaticamente para todas as aplicações, assegurando a disponibilidade do serviço nesse período.

• Se todas as instâncias de uma aplicação forem removidas da lista de instâncias na instância MSE, o sistema ativa automaticamente uma proteção contra lista vazia de um minuto para essa aplicação. Essa medida evita acionamentos inesperados causados por instabilidade de rede ou falhas temporárias nos provedores, mantendo a disponibilidade do serviço.