Microservices Engine:Protection contre les listes vides

Limites

Le client Java Nacos version 1.4.1 ou ultérieure prend en charge la protection contre les listes vides.

Procédure

• Si vous utilisez le client Java Nacos, procédez comme suit :

  1. Ajoutez la dépendance suivante du 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. Configurez les paramètres suivants dans le code de l'application :

     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);

• Si votre application est basée sur Spring Cloud Alibaba, ajoutez la configuration suivante au fichier de configuration de votre application :

  spring.cloud.nacos.discovery.namingPushEmptyProtection=true

• Si votre application est basée sur Dubbo, ajoutez la configuration d'URL de registre suivante au fichier de configuration de votre application Dubbo :

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

Limites

La version du moteur Nacos doit être 2.1.0.0 ou ultérieure. Pour plus d'informations sur la mise à niveau de la version du moteur Nacos, consultez Mettre à jour une version Nacos.

Procédure

La méthode d'activation de la protection contre les listes vides varie selon la version de votre moteur MSE Nacos.

• Si la version de votre moteur MSE Nacos est 2.1.0.0 ou 2.1.0.1, aucune action n'est requise. La protection contre les listes vides est automatiquement activée dans ces versions.

• Si la version de votre moteur MSE Nacos est 2.1.0.2 ou ultérieure, suivez les étapes ci-dessous pour activer la protection contre les listes vides :

  1. Connectez-vous à la console MSE et sélectionnez une région dans la barre de navigation supérieure.

  2. Dans le volet de navigation de gauche, choisissez Microservices Registry > Instances.

  3. Sur la page Instances, cliquez sur le nom de l'instance.

  4. Dans le volet de navigation de gauche, cliquez sur Parameter Settings. Dans la section Real-time Effective Parameters de la page Parameter Settings, cliquez sur Edit dans la colonne Actions du paramètre forcePushEmptyProtectionForAllService.

  5. Dans la boîte de dialogue Edit Parameters, sélectionnez Yes pour Value et cliquez sur OK.

     Remarque

     Pour garantir une disponibilité maximale du service, nous vous recommandons de sélectionner Yes pour Value du paramètre forcePushEmptyProtectionForAllService dans tous les cas.

Vérifier le résultat

Lorsqu'un service déclenche la protection contre les listes vides, le message Trigger push empty protection for Service s'affiche dans le fichier naming.log situé dans le répertoire ${user.home}/logs/nacos du nœud où réside le consommateur.

Normalement, ce type d'information n'apparaît pas fréquemment. Si ces messages apparaissent souvent, vous pouvez résoudre le problème en examinant les causes possibles suivantes :

• Les fournisseurs auxquels le consommateur est abonné n'existent pas.

  Si le consommateur est abonné à un fournisseur inexistant, vérifiez si la dépendance applicative est nécessaire. Si elle ne l'est pas, supprimez la dépendance invalide. Si elle est requise, republiez le fournisseur.

• Aucun fournisseur n'apparaît dans la liste des instances.

  • Vérifiez si les fournisseurs auxquels le consommateur est abonné subissent des déconnexions fréquentes.

  • Vérifiez si la connexion réseau entre chaque fournisseur et l'instance MSE Nacos est normale. En cas d'anomalie réseau, l'instance MSE Nacos considère que le fournisseur est déconnecté.

Identifier le service qui déclenche la protection contre les listes vides

Le message d'erreur contient des informations sur le service qui déclenche la protection contre les listes vides. Vous pouvez identifier le service vide auquel le consommateur est abonné en vous basant sur Service{namespace='XXX', group='xx', name='xxxxxxx', ephemeral=true, revision=0}.

Scénarios de déclenchement connus

Scénarios d'activation forcée de la protection contre les listes vides

Dans MSE Nacos 2.1.0.2 ou ultérieur, la logique d'activation de la protection contre les listes vides a été optimisée. Cette optimisation garantit que la protection contre les listes vides est activée uniquement si Yes est sélectionné pour Value du paramètre forcePushEmptyProtectionForAllService. Toutefois, le système active toujours automatiquement la protection contre les listes vides pour assurer la disponibilité et la stabilité dans les scénarios suivants, même si No est sélectionné pour Value du paramètre forcePushEmptyProtectionForAllService.

• Lors de la mise à niveau, du redémarrage ou de la récupération après panne d'un nœud de moteur, le nœud active automatiquement une protection contre les listes vides de deux minutes pour toutes les applications afin de garantir la disponibilité du service pendant cette période.

• Si toutes les instances d'une application sont supprimées de la liste des instances d'application sur l'instance MSE, l'instance MSE active automatiquement une protection contre les listes vides d'une minute pour l'application. Cette opération empêche le déclenchement inattendu de la protection contre les listes vides en cas de problèmes tels que des performances réseau instables ou des pannes temporaires des fournisseurs de services. Ainsi, la disponibilité du service est assurée dans ce scénario.