How to use a self-managed Nacos service registry and host an application in SAE - Serverless App Engine

Lorsque vous hébergez une application Spring Cloud ou Dubbo développée localement sur SAE, vous pouvez utiliser le registre de services intégré fourni par SAE ou configurer une instance Nacos gérée par vos soins pour l'enregistrement et la découverte des services. Cette rubrique explique comment configurer l'enregistrement et la découverte des services basés sur Nacos pour votre application dans la console SAE.

Recommandations

Si vous disposez d'un grand nombre d'applications microservices, privilégiez l'un des types de registres de services suivants, classés par ordre de recommandation décroissant :

Registre MSE Nacos
Registre de services géré par vos soins
Registre de services intégré à SAE

SAE fournit un serveur Nacos intégré qui prend en charge l'adressage automatique pour les microservices Java. Configurez-le via la fonctionnalité Service Registration and Discovery de SAE.

Prérequis

La commande yum est installée.
Avant d'exécuter l'application, assurez-vous que le port d'accès du registre de services Nacos (par exemple, le port 8848) est autorisé dans un groupe de sécurité. Pour plus d'informations, consultez la rubrique Ajouter une règle de groupe de sécurité.

Étape 1 : Configurer le serveur Nacos

Installez et démarrez une instance Nacos gérée par vos soins. Nacos nécessite un environnement Java. Si vous compilez et exécutez Nacos à partir du code source, configurez également un environnement Maven.

Suivez les instructions du guide Démarrage rapide de Nacos. Une fois Nacos installé et démarré, il assure l'enregistrement et la découverte des services. Spécifiez ensuite le registre de services côté application. Le système effectue alors automatiquement l'enregistrement et la découverte des services selon le registre spécifié.

Étape 2 : Configurer l'enregistrement et la découverte des services dans SAE

Cette rubrique décrit uniquement les étapes clés. Pour la procédure complète de création d'une application, reportez-vous à la documentation dédiée.

Le point d'entrée varie selon votre scénario :

Créer une application

Connectez-vous à la console SAE. Dans le volet de navigation de gauche, choisissez Application Management > Application List. Sélectionnez la région et le namespace cibles, puis cliquez sur Create Application.
Sur la page de l'assistant Basic Information, configurez les paramètres, puis cliquez sur Next: Advanced Settings.

Modifier une application en cours d'exécution

Avertissement

Le redéploiement d'une application entraîne son redémarrage. Pour éviter des erreurs imprévisibles telles que des interruptions de service, nous vous recommandons de déployer les applications pendant les heures creuses.

Connectez-vous à la console SAE. Dans le volet de navigation de gauche, choisissez Application Management > Application List. Sélectionnez la région et le namespace cibles, puis cliquez sur le nom de l'application cible.
Sur la page Basic Information de l'application cible, cliquez sur Deploy Application.

Modifier une application arrêtée

Connectez-vous à la console SAE. Dans le volet de navigation de gauche, choisissez Application Management > Application List. Sélectionnez la région et le namespace cibles, puis cliquez sur le nom de l'application cible.
Sur la page Basic Information de l'application cible, cliquez sur Modify Application Configuration.

Utilisez l'une des méthodes suivantes pour vous connecter à Nacos selon vos besoins :

Méthode 1 : Configurer l'enregistrement et la découverte des services

Recherchez et développez la section Service Registration and Discovery, puis définissez l'option Nacos-based Registry Service and Discovery sur Self-managed Registry (Nacos, ZK, etc.).

Après avoir sélectionné Self-managed Registry (Nacos, ZK, etc.), configurez manuellement l'adresse du registre de services dans votre application et assurez-vous que celle-ci peut se connecter au registre via le réseau.

Méthode 2 : Configurer les paramètres de démarrage

Lorsque vous utilisez des paramètres de démarrage, vérifiez les points suivants :

Assurez-vous que le réseau SAE peut communiquer avec le réseau de votre instance Nacos gérée par vos soins.

Vérifiez que les paramètres -D et -XX ne sont pas mélangés. Dans le cas contraire, la commande risque de ne pas prendre effet. L'exemple suivant montre une commande de démarrage avant et après modification :

Avant la modification :

java -Dalicloud.deployment.mode=EDAS_MANAGED -XX:+UseContainerSupport -XX:InitialRAMPercentage=70.0 -XX:MaxRAMPercentage=70.0 -XX:+UnlockExperimentalVMOptions -XX:+UseWisp2 -Dio.netty.transport.noNative=true -XX:+UseG1GC -Dspring.profiles.active=yace -Dnacos.use.endpoint.parsing.rule=false -Dnacos.use.cloud.namespace.parsing=false -jar /home/admin/app/xx-server.jar

Après la modification :

java -XX:+UseContainerSupport -XX:InitialRAMPercentage=70.0 -XX:MaxRAMPercentage=70.0 -XX:+UnlockExperimentalVMOptions -XX:+UseWisp2 -Dio.netty.transport.noNative=true -XX:+UseG1GC -Dspring.profiles.active=yace -Dnacos.use.endpoint.parsing.rule=false -Dnacos.use.cloud.namespace.parsing=false -jar /home/admin/app/xx-server.jar

La seule différence réside dans la suppression du paramètre -Dalicloud.deployment.mode=EDAS_MANAGED dans la commande modifiée.

En tant que bonne pratique, déployez l'application à l'aide d'une image ou d'un package JAR, et configurez les paramètres de démarrage -Dnacos.use.endpoint.parsing.rule=false et -Dnacos.use.cloud.namespace.parsing=false.

Important

Placez les paramètres de démarrage avant -jar. Dans le cas contraire, votre application risque de ne pas pouvoir utiliser un registre autre que le registre de services intégré à SAE.
Si vous déployez l'application à l'aide d'une image, configurez les options -Dnacos.use.endpoint.parsing.rule=false et -Dnacos.use.cloud.namespace.parsing=false dans la commande de démarrage de l'application du fichier image. Pour plus d'informations sur la création d'une image Docker, consultez la rubrique Créer une image.

Exemple de code :
```
RUN echo 'eval exec java -Dnacos.use.endpoint.parsing.rule=false -Dnacos.use.cloud.namespace.parsing=false -jar $CATALINA_OPTS /home/admin/app/hello-edas-0.0.1-SNAPSHOT.jar'> /home/admin/start.sh && chmod +x /home/admin/start.sh
```
Si vous déployez l'application à l'aide d'un package JAR, accédez à la section Startup Command Settings dans la console et saisissez -Dnacos.use.endpoint.parsing.rule=false -Dnacos.use.cloud.namespace.parsing=false dans la zone de texte Options Settings. Pour plus d'informations, consultez la rubrique Définir une commande de démarrage.