实现配置管理

步骤一：使用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函数，启动应用。

步骤二：部署到SAE

在本地完成应用的开发和测试后，您可以将应用程序部署到SAE。具体操作，请参见应用托管概述。

• SAE配置管理中心提供正式商用版本的Nacos Server。当您将应用部署到SAE时，SAE会通过优先级更高的方式去设置Nacos Server服务端地址和服务端口，以及namespace、access-key、secret-key和context-path信息。您无需进行任何额外的配置，原有的配置内容可以选择保留或删除。

• 您初次在SAE控制台进行部署时，如果选择JAR包部署，在创建应用时，应用运行环境必须选择标准Java应用运行环境。

在部署应用前，请使用SAE的配置管理功能，创建与本地Nacos Server中相同的应用配置。

1. 登录SAE控制台。

2. 在左侧导航栏，选择应用管理 > 分布式配置管理，在顶部菜单栏选择地域。

3. 在配置列表页面，选择命名空间并单击创建配置。

4. 在创建配置面板，配置相关参数，单击创建。

   配置项	说明
   Data ID	配置ID，以nacos-config-example.properties为例。 采用类似package.class（如com.taobao.tc.refund.log.level）的命名规则保证全局唯一性。建议根据配置的业务含义定义class部分。
   Group	配置分组（命名空间），以DEFAULT_GROUP为例。 建议填写产品名:模块名（如 ACM:Test）保证唯一性。后续可以根据Group进行鉴权。
   数据加密	配置数据是否加密。如果您的配置中包含敏感数据，建议您使用加密存储功能，降低配置泄露风险。 重要 ACM数据加密功能依赖密钥管理服务，因此使用前必须开通密钥管理服务，并授权ACM使用密钥管理服务进行加解密。加密配置的Data ID均以cipher-开头，具体操作，请参见创建和使用加密配置。
   配置格式	选择配置格式，以TEXT为例。
   配置内容	输入配置的内容，以test.name=nacos-config-test为例。
   配置描述	配置描述信息，便于理解配置含义。
   更多配置
   应用	配置归属的应用名称。
   标签	配置标签。方便您根据自己的维度管理配置，最多支持5个标签。

步骤三：结果验证

部署完成后，您可以通过查看日志确认应用是否启动成功。

1. 执行命令curl http://<应用实例 IP>:<服务端口>。

   例如curl http://192.168.0.34:8080，查看是否返回配置内容nacos-config-test。

2. 登录SAE控制台，将原有配置内容修改为nacos-config-test2，再执行命令curl http://<应用实例 IP>:<服务端口>。

   例如curl http://192.168.0.34:8080，查看是否返回变更后的配置内容nacos-config-test2。

配置项参考

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

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