Enterprise Distributed Application Service:Gerenciar configurações de aplicação

Como o Data ID mapeia para sua aplicação

O Data ID segue esta convenção de nomenclatura:

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

Neste tutorial, o nome da aplicação é nacos-config-example sem perfil ativo, portanto o Data ID é nacos-config-example.properties.

3a. Criar um projeto Maven

Crie um projeto Maven chamado nacos-config-example.

3b. Adicionar dependências

Adicione o seguinte ao pom.xml. Este exemplo usa Spring Boot 2.1.4.RELEASE com 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. Criar a classe de inicialização

Em src/main/java, crie o pacote com.aliware.edas e adicione a seguinte classe NacosConfigExampleApplication:

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. Criar um controller

No mesmo pacote, crie uma classe EchoController. A anotação @RefreshScope habilita a atualização dinâmica da configuração: quando test.name muda no Nacos, a aplicação obtém o novo valor sem reinicialização.

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. Configurar o endereço do Nacos Server

Em src/main/resources, crie um arquivo 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 — o endereço do Nacos Server.

• 18081 — a porta da aplicação.

Se o Nacos Server estiver executando em outra máquina, atualize o endereço e a porta. Consulte a Referência de configuração para propriedades adicionais.

Verificar a configuração inicial

1. Execute o método main em NacosConfigExampleApplication para iniciar a aplicação.

2. Abra http://127.0.0.1:18081 no navegador. A resposta será nacos-config-test — o valor de test.name definido na Etapa 2.

Verificar a atualização dinâmica da configuração

1. No console do Nacos Server, acesse ConfigManagement > Configurations e edite a entrada nacos-config-example.properties.

2. Altere test.name=nacos-config-test para test.name=nacos-config-updated e clique em Publish.

3. Atualize a página http://127.0.0.1:18081. A resposta agora exibe nacos-config-updated, confirmando que o @RefreshScope funciona sem reiniciar a aplicação.

5a. Criar a configuração no EDAS

1. Faça login no console do EDAS.

2. No painel de navegação à esquerda, selecione Application Management > Microservice Configurations.

3. Na página Configurations, selecione uma Region na barra de navegação superior e um Microservices Namespace no menu suspenso. Em seguida, clique em Create Configuration.

4. No painel Create Configuration, defina os mesmos parâmetros da configuração local do Nacos e clique em Create:

   Parâmetro	Valor
   Data ID	nacos-config-example.properties
   Group	DEFAULT_GROUP
   Format	Properties
   Configuration Content	test.name=nacos-config-test

5b. Implantar a aplicação

Implante a aplicação no EDAS. Escolha um método de implantação adequado à sua infraestrutura:

• Implantar no ECS

• Implantar no Kubernetes