Microservices Engine:Upgrade the Nacos engine version

Contexte

Afin d'améliorer les services et de simplifier le choix de l'édition pour MSE Microservices Registry, les services de l'édition Basique seront interrompus et les ressources des instances libérées le 3 mars 2025 à 12 h 00 (UTC+8). Passé ce délai, vous ne pourrez plus accéder à ces instances depuis la console ou vos applications. Le support et les services de ticketing pour les instances de l'édition Basique resteront disponibles jusqu'à la date limite. Pour plus de détails, consultez l'Annonce d'arrêt de l'édition Basique de MSE Microservices Registry.

Avant de commencer

• Sélectionnez une édition d'instance : Avant la mise à niveau, consultez le Guide de sélection de l'édition d'instance pour décider s'il convient de passer à l'édition Développeur ou Professionnelle. Pour les détails de facturation, reportez-vous à la Présentation de la facturation des instances courantes.

• Évaluez les spécifications : Lors de la mise à niveau, MSE Nacos effectue une double écriture des données des services enregistrés afin de garantir la cohérence des données et la stabilité de l'opération. Avant de commencer, assurez-vous que le nombre d'instances fournisseurs dans votre cluster ne dépasse pas le nombre maximal d'instances autorisé pour l'édition Basique correspondant aux spécifications, afin d'éviter tout impact sur vos services durant la double écriture. Pour plus d'informations, consultez Évaluer les capacités des instances courantes.

• Vérifiez la version du moteur : Vous ne pouvez mettre à niveau une instance de l'édition Basique vers l'édition Professionnelle ou Développeur que si votre moteur Nacos est en version 1.2.1.0 ou ultérieure. Si vous utilisez une version 1.1.3.x, vous devez d'abord effectuer la mise à niveau vers la version 1.2.1, puis procéder à la mise à niveau de l'édition de l'instance. Pour les instructions, consultez Mettre à niveau la version du moteur Nacos.

• Examinez la compatibilité des versions du moteur : Pour connaître les fonctionnalités associées aux versions du moteur MSE Nacos, consultez Versions du moteur Nacos. Par souci de stabilité du système, nous recommandons d'éviter les versions du SDK Nacos restreintes. Pour connaître les raisons et les solutions, consultez Versions du SDK Nacos restreintes.

• Moteur Eureka : Le service Eureka géré par MSE a été arrêté. MSE Nacos prend en charge le protocole Eureka et est compatible avec les clients Eureka. Nous vous recommandons de migrer vos instances Eureka de l'édition Basique vers l'édition Professionnelle ou Développeur de MSE Nacos.

Impact de la mise à niveau

• La mise à niveau dure environ 10 minutes. Pendant cette période, vous ne pouvez effectuer aucune opération sur l'instance dans la console. Nous vous recommandons d'effectuer la mise à niveau pendant les heures creuses afin d'éviter toute perturbation de vos services.

• Pour les instances comportant trois nœuds ou plus, la mise à niveau utilise un déploiement progressif sur les nœuds avec synchronisation automatique des données, garantissant ainsi une mise à niveau sans interruption de service.

• Pour la plupart des services, la mise à niveau est transparente. Toutefois, les reconnexions réseau durant l'opération peuvent générer certains journaux d'erreurs de reconnexion et d'accès. Il s'agit d'un comportement attendu. Les données de surveillance peuvent également présenter de brèves fluctuations dues au redémarrage du cluster.

• Dans certains scénarios particuliers, une mise à niveau sans perte de service n'est pas garantie. Avant d'effectuer la mise à niveau, vérifiez les conditions suivantes :

  • Les instances composées d'un ou deux nœuds ne sont pas des instances haute disponibilité (HA), par conséquent la mise à niveau entraînera une interruption de service.

  • Si vous utilisez une version cliente ancienne, il existe une très faible probabilité qu'une perte de paquets ou d'autres anomalies imprévues durant la mise à niveau déclenchent un bogue client, provoquant la mise hors ligne de vos services. Dans ce cas, la mise à niveau entraînera une interruption de service.

  • Si vous utilisez une version antérieure de Spring Cloud Alibaba et avez configuré le chemin de contrôle de santé Spring Cloud Actuator comme sonde liveness ou readiness pour votre service, en raison d'un bogue présent dans les anciennes versions de Spring Cloud Alibaba, il existe une très faible probabilité qu'un échec de la sonde provoque le redémarrage automatique de votre application. Dans ce cas, la mise à niveau entraînera une interruption de service.

• Lors de la migration d'un moteur Eureka vers l'édition Professionnelle ou Développeur de Nacos :

  • Vous n'avez pas besoin de modifier le code de votre application.

  • Les reconnexions réseau durant la mise à niveau peuvent entraîner l'échec du renouvellement des battements de cœur pour un petit nombre d'instances enregistrées. Les clients Eureka retentent automatiquement l'enregistrement lors de leur prochain renouvellement et récupèrent après s'être connectés à un nœud serveur sain.

  • Par défaut, une instance Eureka de l'édition Basique est migrée vers l'édition Développeur ou Professionnelle de Nacos avec la version 2.1.2.2 du moteur. Vous pourrez ensuite effectuer la mise à niveau vers la dernière version de Nacos. Pour plus d'informations, consultez Mettre à niveau la version du moteur Nacos.

Chemin de mise à niveau

Vous ne pouvez mettre à niveau l'édition Basique vers l'édition Professionnelle ou Développeur que si votre moteur Nacos est en version 1.2.1.0 ou ultérieure. Si vous utilisez une version 1.1.3.x, vous devez d'abord mettre à niveau le moteur vers la version 1.2.1. Pour les instructions, consultez Mettre à niveau la version du moteur Nacos.

Mettre à niveau la version du moteur Nacos

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

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

3. Vous pouvez lancer la mise à niveau depuis la console de deux manières :

   Remarque

   Si l'instance cible est déjà à la dernière version, l'option Manual Upgrade n'est pas affichée.

   Méthode 1

   Sur la page Instances, repérez l'instance cible et cliquez sur Manual Upgrade dans la colonne Engine Version.

   Méthode 2

   Sur la page Instances, cliquez sur l'instance que vous souhaitez mettre à niveau. Sur la page Basic Information, cliquez sur Manual Upgrade à côté de Engine Version.

4. Dans la boîte de dialogue Cluster Upgrade, cliquez sur OK.

Mettre à niveau l'édition Basique Nacos/Eureka

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

2. Sur la page Instances, repérez l'instance MSE, puis cliquez sur More dans la colonne Actions.

   • Pour une instance par abonnement, sélectionnez Upgrade ou Downgrade selon vos besoins métier.

   • Pour une instance à la demande, sélectionnez Upgrade/Downgrade.

3. Sur la page de modification des spécifications, sélectionnez une Product Edition :

   • Pour les instances à nœud unique, sélectionnez l'édition Développeur.

   • Pour les instances multinœuds, sélectionnez l'édition Professionnelle.

   Important

   Les limitations suivantes s'appliquent lors de la modification de la Product Edition :

   • Une instance Basic Edition peut être mise à niveau vers l'Developer Edition ou la Professional Edition.

   • Une instance Developer Edition ne peut être mise à niveau que vers une version ultérieure de l'Developer Edition. Elle ne peut pas être mise à niveau vers la Professional Edition.

   • Une instance Professional Edition ne peut être mise à niveau que vers une version ultérieure de la Professional Edition. Elle ne peut pas être rétrogradée vers l'Developer Edition.

4. Confirmez les paramètres Engine specification et Number of Cluster Nodes. Après avoir vérifié le coût total affiché en bas à droite, cliquez sur Buy now.

FAQ

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>${springcloudalibaba.version}</version>
    <exclusions>
        <exclusion>
        <groupId>com.alibaba.nacos</groupId>
        <artifactId>nacos-client</artifactId>
         </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>${springcloudalibaba.version}</version>
    <exclusions>
        <exclusion>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.alibaba.nacos</groupId>
    <artifactId>nacos-client</artifactId>
    <version>2.0.2</version>
</dependency>

<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-registry-nacos</artifactId>
    <version>${dubbo.version}</version>
    <exclusions>
        <exclusion>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.alibaba.nacos</groupId>
    <artifactId>nacos-client</artifactId>
    <version>2.0.2</version>
</dependency>