Enterprise Distributed Application Service:Manage application configurations

Correspondance entre le Data ID et votre application

Le Data ID suit cette convention de nommage :

${prefix}-${spring.profiles.active}.${file-extension}

Dans ce tutoriel, le nom de l'application est nacos-config-example sans profil actif, donc le Data ID est nacos-config-example.properties.

3a. Créer un projet Maven

Créez un projet Maven nommé nacos-config-example.

3b. Ajouter les dépendances

Ajoutez les éléments suivants dans pom.xml. Cet exemple utilise Spring Boot 2.1.4.RELEASE avec Spring Cloud Greenwich.SR1 :

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.1.4.RELEASE</version>
    <relativePath/>
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        <version>2.1.1.RELEASE</version>
    </dependency>
</dependencies>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>Greenwich.SR1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

3c. Créer la classe de démarrage

Sous src/main/java, créez le package com.aliware.edas et ajoutez la classe NacosConfigExampleApplication suivante :

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

3d. Créer un contrôleur

Dans le même package, créez une classe EchoController. L'annotation @RefreshScope permet l'actualisation dynamique de la configuration : lorsque test.name change dans Nacos, l'application récupère la nouvelle valeur sans redémarrage.

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RefreshScope
public class EchoController {

    @Value("${test.name}")
    private String userName;

    @RequestMapping(value = "/")
    public String echo() {
        return userName;
    }
}

3e. Configurer l'adresse du serveur Nacos

Sous src/main/resources, créez un fichier bootstrap.properties :

spring.application.name=nacos-config-example
server.port=18081
spring.cloud.nacos.config.server-addr=127.0.0.1:8848

• 127.0.0.1:8848 : adresse du serveur Nacos.

• 18081 : port de l'application.

Si le serveur Nacos s'exécute sur une autre machine, mettez à jour l'adresse et le port. Consultez la référence de configuration pour connaître les propriétés supplémentaires.

Vérifier la configuration initiale

1. Exécutez la méthode main dans NacosConfigExampleApplication pour démarrer l'application.

2. Ouvrez http://127.0.0.1:18081 dans un navigateur. La réponse est nacos-config-test , soit la valeur de test.name que vous avez définie à l'étape 2.

Vérifier l'actualisation dynamique de la configuration

1. Dans la console du serveur Nacos, accédez à ConfigManagement > Configurations et modifiez l'entrée nacos-config-example.properties.

2. Remplacez test.name=nacos-config-test par test.name=nacos-config-updated et cliquez sur Publish.

3. Actualisez la page http://127.0.0.1:18081. La réponse affiche désormais nacos-config-updated , ce qui confirme que l'annotation @RefreshScope fonctionne sans redémarrage de l'application.

5a. Créer la configuration dans EDAS

1. Connectez-vous à la console EDAS.

2. Dans le volet de navigation de gauche, sélectionnez Application Management > Microservice Configurations.

3. Sur la page Configurations, sélectionnez une Region dans la barre de navigation supérieure et un Microservices Namespace dans la liste déroulante. Cliquez ensuite sur Create Configuration.

4. Dans le panneau Create Configuration, définissez les mêmes paramètres que pour la configuration Nacos locale et cliquez sur Create :

   Paramètre	Valeur
   Data ID	nacos-config-example.properties
   Group	DEFAULT_GROUP
   Format	Properties
   Configuration Content	test.name=nacos-config-test

5b. Déployer l'application

Déployez l'application sur EDAS. Choisissez une méthode de déploiement selon votre infrastructure :

• Déployer sur ECS

• Déployer sur Kubernetes