SpringCloud中把nacos做为配置中心

把配置文件到nacos里面写

1. Nacos简介

    Nacos除了实现了服务的注册发现之外，还将配置中心功能整合在了一起，

    通过Nacos的配置管理功能，我们可以将整个架构体系内的所有配置都集中在Nacos中存储。

    另外，在分布式系统中，由于服务数量巨多，为了实现更灵活的管理权限、安全性，

    实时更新以及一次打包，多处运行，所以需要分布式配置中心组件

    Spring Cloud Alibaba Nacos Config

2. 快速实现Nacos作为配置中心(私有配置)

   1.进入Nacos的控制页面，在配置列表功能页面中，点击右上角的“+”按钮，进入“新建配置”页面

      Data ID：填入nacos-config-client.yml，注意：Data ID 的默认扩展名为 .properties ，希望使用yml配置，此处必须指明是*.yml

      Group： 不修改，使用默认值DEFAULT_GROUP

      配置格式：选择yaml

      配置内容：应用要加载的配置内容，这里仅作为示例(注：请将下面内容改成yml格式填入，这里是为了书写方便)

                       cnf.message=hello nacos config clent

      注1：当新建配置的DataID的值与模块名相同时，表示此配置是此模块的私有配置

   2.导入nacos配置中心客户端依赖

      <!--Nacos配置中心客户端依赖(与Eureka不同没有服务端)，在需要使用配置中心的模块才导入此依赖-->

      <dependency>

          <groupId>com.alibaba.cloud</groupId>

          <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>

      </dependency>  

     

   3.创建配置文件bootstrap.yml，并配置服务名称和Nacos地址(注：请将下面内容改成yml格式填入，这里是为了书写方便)

      server.port=7301                                                                            #项目端口号(boostrap.yml中配置后，可在application.yml中不配置)

      spring.application.name=nacos-config-client                               #应用名对应nacos配置中心的Data Id

      spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848           #指定nacos注册中心地址(boostrap.yml中配置后，可在application.yml中不配置)

      spring.cloud.nacos.config.prefix=${spring.application.name}      #不填写默认就是项目的应用名

      spring.cloud.nacos.config.server-addr=127.0.0.1:8848                #指定nacos配置中心地址

      spring.cloud.nacos.config.file-extension=yml                              #指定配置文件后缀名

      这里有两个坑：1. 配置文件必须是bootstrap.properties或者bootstrap.yml，如果配置application.properties或者application.yml会导致加载不到配置；

                              2. spring.cloud.nacos.config.namespace如果是默认的public，则不需填写，否则获取不到配置信息

      详情见：资料/nacos-config-client-bootstrap.yml

   4. 创建NacosConfigController进行配置信息的读取

       @Value("${cnf.message}")

       

   5. @RefreshScope实现自动刷新

       此注解主要用来让这个类下的配置内容支持动态刷新，也就是当我们的应用启动之后，修改了Nacos中的配置内容之后，这里也会马上生效

      

2. Nacos实现共享配置

    之前讲的都当前项目的私有配置，但一个真实项目中还会有许多的共享配置，比方说数据库、redis、log4j日志配置等，这些都可以放到nacos中，做到配置的共享加载与统一管理

    

   1.进入Nacos的控制页面，创建新的配置文件db.yml,hello.yml

      username=zs

      password=123

      hello=hello nacos

   2.修改bootstrap.yml添加如下配置                     

      spring.cloud.nacos.config.shared-dataids=db.yml,hello.yml                                     

      spring.cloud.nacos.config.refreshable-dataids=db.yml,hello.yml

      注1：spring.cloud.nacos.config.shared-dataids参数用来配置多个共享配置的Data Id，多个的时候用用逗号分隔

      注2：spring.cloud.nacos.config.refreshable-dataids参数用来定义哪些共享配置的Data Id在配置变化时，应用中可以动态刷新，多个Data Id之间用逗号隔开。如果没有明确配置，默认情况下所有共享配置都不支持动态刷新

      注3：不能省略后缀名yml或properties

3. 多环境的配置管理

    本例使用了nacos的命名空间，来实现不同环境的切换，这也是nacos官方推荐的方式。还有其它两种方式，了解可参考附录四，详情请参考：资料/04,05,06

    

    1.进入Nacos的控制页面，创建新的命名空间dev/test/prd

    2.在配置列表的最上方，可以看到除了public之外，多了几个刚才创建的namepsace。分别在dev/test/prd空间下为nacos-config-client应用创建配置内容

       nacos-config-client.yml

       db.yml

       hello.yml

    3.修改bootstrap.yml添加如下配置

       spring.cloud.nacos.config.namespace=83eed625-d166-4619-b923-93df2088883a   #这里需要注意namespace的配置不是使用名称，而是使用Namespace的ID。

       注意事项：对于指定环境的配置

      （spring.cloud.nacos.config.namespace=83eed625-d166-4619-b923-93df2088883a），

       都不要配置在应用的bootstrap.yml中。而是在发布脚本的启动命令中，

       用-Dspring.profiles.active=DEV的方式来动态指定，会更加灵活

       语法格式：java -jar xxx.jar --a1=aaa --b1=bbb

       java -jar nacos-config-client.jar --spring.cloud.nacos.config.namespace=d43d645d-0567-40f7-97d0-a39e2f0216b1

       

附录一：yml和properties文件区别

1.首先yml和properties文件都是属于配置文件，功能一样，使用哪种方式自己开心就好，建议使用yml，因为树状结构更加清晰，代码更少

附录二：application.yml和 bootstrap.yml区别

1.主要是application和bootstrap的加载顺序

   bootstrap.yml在application.yml之前加载，用于应用程序上下文的引导阶段

   注意：Spring Boot 配置文件的加载顺序，依次为 bootstrap.properties -> bootstrap.yml -> application.properties -> application.yml ，其中 bootstrap.properties 配置为最高优先级

     

2.典型场景

   1.当使用 Spring Cloud Config Server的时候，你应该在 bootstrap.yml里面指定spring.application.name和spring.cloud.nacos.config.server-addr

   2.一些加密/解密的信息

3.属性覆盖问题

   1.启动上下文时，Spring Cloud会创建一个Bootstrap Context，作为Spring应用的Application Context的父上下文。Bootstrap Context属性有高优先级，默认情况下，它们不会被本地配置覆盖。

   2.初始化的时候，Bootstrap Context负责从外部源加载配置属性并解析配置。这两个上下文共享一个从外部获取的Environment。

   3.Bootstrap context和Application Context有着不同的约定，所以新增了一个bootstrap.yml文件，而不是使用application.yml (或者application.properties)。保证Bootstrap Context和Application Context配置的分离   

附录三：Nacos共享配置的两种实现方式

shared-dataids方式：

适合于共享配置文件与项目默认配置文件处于相同Group时，直接两条命令就可以搞定

优点：配置方便

缺点：只能在同一Group中

ext-config方式：

它可以由开发者自定义要读取的共享配置文件的DataId、Group、refresh属性，这样刚好解决了shared-dataids存在的局限性。

优点：可以与shared-dataids方案结合使用，用户自定义配置。灵活性强

缺点：配置容易出错，要熟悉YAML语法

附录四：利用Nacos配置管理功能中的几个不同纬度来实现多环境的配置管理

第一种：通过Data ID与profile实现。

优点：这种方式与Spring Cloud Config的实现非常像，用过Spring Cloud Config的用户，可以毫无违和感的过渡过来，由于命名规则类似，所以要从Spring Cloud Config中做迁移也非常简单。

缺点：这种方式在项目与环境多的时候，配置内容就会显得非常混乱。配置列表中会看到各种不同应用，不同环境的配置交织在一起，非常不利于管理。

建议：项目不多时使用，或者可以结合Group对项目根据业务或者组织架构做一些拆分规划。

第二种：通过Group实现。

优点：通过Group按环境讲各个应用的配置隔离开。可以非常方便的利用Data ID和Group的搜索功能，分别从应用纬度和环境纬度来查看配置。

缺点：由于会占用Group纬度，所以需要对Group的使用做好规划，毕竟与业务上的一些配置分组起冲突等问题。

建议：这种方式虽然结构上比上一种更好一些，但是依然可能会有一些混乱，主要是在Group的管理上要做好规划和控制。

第三种：通过Namespace实现。

优点：官方建议的方式，通过Namespace来区分不同的环境，释放了Group的自由度，这样可以让Group的使用专注于做业务层面的分组管理。同时，Nacos控制页面上对于Namespace也做了分组展示，不需要搜索，就可以隔离开不同的环境配置，非常易用。

缺点：没有啥缺点，可能就是多引入一个概念，需要用户去理解吧。

建议：直接用这种方式长远上来说会比较省心。虽然可能对小团队而言，项目不多，第一第二方式也够了，但是万一后面做大了呢？

注意：不论用哪一种方式实现。对于指定环境的配置（spring.profiles.active=DEV、spring.cloud.nacos.config.group=DEV_GROUP、spring.cloud.nacos.config.namespace=83eed625-d166-4619-b923-93df2088883a），都不要配置在应用的bootstrap.properties中。而是在发布脚本的启动命令中，用-Dspring.profiles.active=DEV的方式来动态指定，会更加灵活

附录四：

management.endpoints.web.exposure.include=*，默认只公开了/health和/info端点，要想暴露所有端点只需设置成星号即可