实现配置管理

您可以按照文档从头开发该应用示例，使用 Spring Cloud Alibaba Nacos Config 实现配置管理。也可以直接下载该应用示例的 Demo nacos-config-example。

准备工作

在开始开发前，请确保您已经完成以下工作：

• 下载 Maven 并设置环境变量。
• 下载最新版本的 Nacos Server。
• 启动 Nacos Server。
  1. 解压下载的 Nacos Server 压缩包
  2. 进入nacos/bin目录，启动 Nacos Server。
     • Linux/Unix/Mac 系统：执行命令sh startup.sh -m standalone。

     • Windows 系统：双击执行startup.cmd文件。

• 在本地 Nacos Server 控制台新建配置。
  1. 登录本地 Nacos Server 控制台（用户名和密码默认同为 nacos）。
  2. 在左侧导航栏中单击配置列表，在配置列表页面右上角单击新建配置图标。
  3. 在新建配置页面填入以下信息，单击并发布。
     • Data ID: nacos-config-example.properties
     • Group: DEFAULT_GROUP
     • 配置内容: test.name=nacos-config-test

  4. 在本地开发应用时，可以使用 Alibaba Cloud Toolkit 插件实现本地应用和部署在 EDAS 中的应用的相互调用，即端云互联，而无需搭建 VPN，帮助您提升开发效率。详情请参见为 EDAS 应用设置端云互联。

使用 Nacos Config 实现配置管理

1. 创建一个 Maven 工程，命名为 nacos-config-example。
2. 在pom.xml文件中添加依赖。

   以 Spring Boot 2.1.4.RELEASE 和 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>                        

   示例中使用的版本为 Spring Cloud Greenwich ，对应 Spring Cloud Alibaba 版本为 2.1.1.RELEASE。

   • 如果使用 Spring Cloud Finchley 版本，对应 Spring Cloud Alibaba 版本为 2.0.1.RELEASE。
   • 如果使用 Spring Cloud Edgware 版本，对应 Spring Cloud Alibaba 版本为 1.5.1.RELEASE。

   说明 Spring Cloud Edgware 版本的生命周期已结束，不推荐使用这个版本开发应用。
3. 在src\main\java下创建 Packagecom.aliware.edas。
4. 在 Packagecom.aliware.edas中创建nacos-config-example 的启动类 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);
           }
       }                        

5. 在 Packagecom.aliware.edas中创建一个简单的 ControllerEchoController，自动注入一个属性userName，且通过@Value注解指定从配置中取 Key 为test.name的值。

       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;
           }
       }                        

6. 在src\main\resources路径下创建配置文件bootstrap.properties，在bootstrap.properties中添加如下配置，指定 Nacos Server 的地址。

   其中127.0.0.1:8848为 Nacos Server 的地址，18081为服务端口。

   如果您的 Nacos Server 部署在另外一台机器，则需要修改成对应的 IP 和端口。如果有其它需求，可以参照配置项参考在bootstrap.properties文件中增加配置。

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

7. 执行NacosConfigExampleApplication中的 main 函数，启动应用。

本地结果验证

在浏览器访问 http://127.0.0.1:18081 ，可以看到返回值为 nacos-config-test ，该值即为在本地 Nacos Server 中新建配置中的配置内容，即test.name的值。

部署到 EDAS

当在本地完成应用的开发和测试后，便可将应用程序打包并部署到 EDAS。您可以根据您的实际情况选择将 Spring Cloud 应用部署到 ECS 集群、容器服务 Kubernetes集群或 EDAS Serverless。部署应用的详细步骤请参见应用部署概述（ECS 集群）和应用部署概述（K8s 集群）。

EDAS 集成的 ACM 即 Nacos 的正式商用版本。当您将应用部署到 EDAS 的时候，EDAS 会通过优先级更高的方式去设置 Nacos 服务端地址和服务端口，以及 namespace、access-key、secret-key、context-path 信息。

在部署应用前，需要在 EDAS 控制台的配置管理中新建和本地 Nacos Server 中相同的配置，具体操作步骤如下：

1. 登录 EDAS 控制台。
2. 在左侧导航栏中选择应用管理 > 配置管理 。
3. 在配置管理页面选择地域和命名空间，并在页面右侧单击新建配置图标 。
4. 在新建配置页面设置 Data ID、Group 和 配置内容，并单击发布。
   • Data ID: nacos-config-example.properties
   • Group: DEFAULT_GROUP
   • 配置内容: test.name=nacos-config-test

第一次部署建议是通过控制台部署，且如果使用 JAR 包部署，在创建应用时应用运行环境务必选择标准 Java 应用运行环境。

结果验证

1. 部署完成后，可以通过查看日志确认应用是否启动成功。
2. 执行命令curl http://<应用实例 IP>:<服务端口>，如curl http://192.168.0.34:8080 查看是否返回配置内容 nacos-config-test。
3. 在 EDAS 控制台将原有配置内容修改为 nacos-config-test2，再执行命令curl http://<应用实例 IP>:<服务端口>，如curl http://192.168.0.34:8080，查看是否返回变更后的配置内容 nacos-config-test2。

配置项参考

如果有其它需求，可以参照下表在bootstrap.properties文件中增加配置。

更多配置项，请参考开源版本的 Spring Cloud Alibaba Nacos Config 文档。