Serverless App Engine:Migration fluide des applications Spring Cloud vers SAE

1. Sélectionner une application

Commencez par les fournisseurs sous-jacents, c'est-à-dire les services qui n'ont aucune dépendance amont. Si la trace d'appel est complexe ou difficile à cartographier, sélectionnez n'importe quelle application pour démarrer.

2. Ajouter des dépendances et mettre à jour la configuration

a. Ajouter la dépendance de découverte Nacos

Ajoutez spring-cloud-starter-alibaba-nacos-discovery au fichier pom.xml :

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>{Version}</version>
</dependency>

b. Configurer l'adresse du serveur Nacos

Ajoutez les éléments suivants au fichier application.properties :

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

c. Ajouter la dépendance de migration multi-registres

Par défaut, Spring Cloud n'autorise qu'un seul registre. L'ajout d'un second registre génère une erreur. La dépendance edas-sc-migration-starter supprime cette restriction et permet l'enregistrement simultané auprès de plusieurs registres.

Ajoutez-la au fichier pom.xml :

<dependency>
    <groupId>com.alibaba.edas</groupId>
    <artifactId>edas-sc-migration-starter</artifactId>
    <version>1.0.2</version>
</dependency>

3. Mettre à jour la configuration RibbonClients

Pour s'abonner aux services de plusieurs registres, configurez @RibbonClients pour utiliser MigrationRibbonConfiguration dans la classe principale.

Avant :

@SpringBootApplication
public class ConsumerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ConsumerApplication.class, args);
    }
}

Après :

@SpringBootApplication
@RibbonClients(defaultConfiguration = MigrationRibbonConfiguration.class)
public class ConsumerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ConsumerApplication.class, args);
    }
}

Après le déploiement de ces modifications, que ce soit sur site ou sur SAE, vous pouvez contrôler les registres auprès desquels l'application s'enregistre ou s'abonne à l'aide de Spring Cloud Config ou Nacos Config, sans redémarrer l'application. Pour plus de détails, consultez les sections Ajuster dynamiquement les politiques d'enregistrement et d'abonnement de services et Gérer les configurations des applications .

4. Déployer l'application sur SAE

Déployez l'application selon vos besoins. Pour plus d'informations, consultez la page Déployer des applications.

5. Vérifier la migration

Utilisez l'une des méthodes suivantes :

Option 1 : Vérifier le comportement métier

Confirmez que votre activité fonctionne comme prévu après le déploiement.

Option 2 : Vérifier la surveillance de l'abonnement aux services

Si Spring Boot Actuator est activé, accédez au point de terminaison suivant pour afficher la liste RibbonServerList pour chaque service abonné. Le champ serverGroup dans metaInfo indique le registre auquel appartient un nœud.

Supprimer les dépendances de migration

Une fois toutes les applications déployées sur SAE, supprimez la configuration du registre d'origine ainsi que la dépendance edas-sc-migration-starter.

Migrer SLB ou mettre à jour les paramètres DNS

Après avoir migré vos applications, gérez votre instance SLB et la configuration de votre nom de domaine :

Instance SLB

Nom de domaine

Migrer le stockage et les files d'attente de messages

Si votre application utilise des services Alibaba Cloud tels qu'ApsaraDB RDS et Message Queue, vous n'avez pas besoin de migrer le stockage ni les files d'attente de messages. Si votre application n'est pas déployée sur Alibaba Cloud, rejoignez le groupe DingTalk 32874633 pour obtenir une assistance technique.

Ajuster la politique d'abonnement

Par défaut, SAE s'abonne aux données de service de tous les registres associés et les agrège.

Pour vous abonner uniquement à des registres spécifiques, définissez la propriété spring.cloud.edas.migration.subscribes :

# Subscribe to services from both Eureka and Nacos
spring.cloud.edas.migration.subscribes=nacos,eureka

# Subscribe to services from Nacos only
spring.cloud.edas.migration.subscribes=nacos

Ajuster la politique d'enregistrement

Par défaut, SAE s'enregistre auprès de tous les registres associés.

Pour exclure des registres spécifiques, définissez la propriété spring.cloud.edas.migration.registry.excludes :

# Register with all registries (default — leave blank)
spring.cloud.edas.migration.registry.excludes=

# Disable registration with Eureka only
spring.cloud.edas.migration.registry.excludes=eureka

# Disable registration with Nacos and Eureka
spring.cloud.edas.migration.registry.excludes=nacos,eureka

Utilisez la fonctionnalité de gestion de configuration de SAE pour mettre à jour cette propriété à l'exécution sans redémarrer vos applications.