SpringBoot集成nacos实现统一配置中心

2年前 (2022) 程序员胖胖胖虎阿
265 0 0

导入依赖

咳咳,划重点,从导入依赖开始,坑就已经来了,哈哈!!!

导入的依赖很有讲究,你是啥springboot版本,然后下面的nacos版本配置就是啥,我也是醉啦。详情看我的配置,我的springboot依赖版本是2.2.6.RELEASE,然后我的nacos赖版版本也是2.2.6.RELEASE。

我强烈建议兄弟你先按照我的springboot 2.2.6.RELEASE 版本来,等看完本篇文章后你再切换成你自己的springboot版本也不迟。

下面罗列了关键的nacos依赖配置及springboot的版本。

    <!-- Spring Boot 启动父依赖 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.6.RELEASE</version>
    </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.2.6.RELEASE</version>
        </dependency>
 </dependencies>

创建命名空间

"命名空间"视为项目。

下载好nacos服务器,我下载的版本是nacos1.1.4。启动 nacos服务器后,创建第一个命名空间"MY_PROJECT"。

这个命名空间专门用于给某个项目专用,刚创建的命名空间的ID是"3dab7b44-83fa-429a-8496-528986c6f54a",记住这个命名空间的id,待会要用到。

SpringBoot集成nacos实现统一配置中心

创建启动分支分组

项目的配置文件空间创建好了,下一步就是创建不同的开发分支。正常会有dev、test、pro分支。

这个分支在nacos中对应的概念就是"Group"。我们简单理解就是开发环境,例如dev、test、pro。

如下图,我们点击"MY_PROJECT",到我们这个项目的统一配置中心来,目前还没有任何配置。

SpringBoot集成nacos实现统一配置中心

我们尝试创建dev环境的分组。如下图,创建dataId为 "demo.properties"group为"dev"的第一个配置文件。配置文件的内容是指定端口为8081,然后自定义一个"author=dayu"的变量,详情请看下图。

这个过程就像我们在以前的application.yaml中配置的那样。配置完后点击"发布" 就好啦。

 SpringBoot集成nacos实现统一配置中心

配置完返回并查看,点击MY_PROJECT命名空间下,我们就配置好了一个dataId是demo.properties的配置文件,且该配置文件属于分组dev,我们把它设计为开发环境需要的参数。未来可以增加更多的分组对应不同的环境,例如test环境、pro环境。

该demo.properties文件的内容很简单,就是"server.port=8081",还有"author=dayu"

SpringBoot集成nacos实现统一配置中心

代码接入nacos

我们在springboot工程中创建一个bootstrap.properties文件,它的加载优先级是最高的。配置详情如下:

# 我是bootstrap.properties配置文件

#服务器地址
spring.cloud.nacos.config.server-addr=127.0.0.1:8848
#项目的命名空间的ID,每个人的都不一样
spring.cloud.nacos.config.namespace=3dab7b44-83fa-429a-8496-528986c6f54a
#当前的Group,配置的是啥Group,读取的就是啥group下的配置文件
spring.cloud.nacos.config.group=dev
#配置文件的文件后缀
spring.cloud.nacos.config.fileExtension=properties
#项目名称
spring.application.name=demo

spring.cloud.nacos.config.server-addr,nacos服务器地址

spring.cloud.nacos.config.namespace,读取的命名空间,就是本文一开始的那个命名空间的id。

spring.application.name=demo,设计我们的项目名称是"demo"。

spring.cloud.nacos.config.fileExtension ,配置文件的文件后缀设计为"properties"。

spring.cloud.nacos.config.group=dev。读取group为dev的配置文件

这段在bootstrap.properties中的配置究竟功能是什么呢?我总结了一段话来描述: 

让我们去读取指定 nacos服务器下的指定的命名空间中的配置文件。这个配置文件的ID 是  ${spring.application.name}.${spring.cloud.nacos.config.fileExtension},且它的group是${spring.cloud.nacos.config.group}。

用配置文件替换上面的这段话:

让我们去读取指定 nacos服务器下的指定的命名空间中的配置文件。这个配置文件的DataId 是  demo.properties,且它的group是dev。

SpringBoot集成nacos实现统一配置中心

再回头看看我们的配置文件,确实就是DataId = demo.properties、Group=dev

SpringBoot集成nacos实现统一配置中心

 启动项目:

控制台打印:

SpringBoot集成nacos实现统一配置中心

 控制台说明加载dataId[demo],默认后缀是properties被省略掉了,group是dev。说明正确。

配置文件中规定了启动端口是8081,项目真的按照了8081端口启动了耶!!!说明了我们已经读取到了nacos统一配置平台的配置。SpringBoot集成nacos实现统一配置中心

 加载多个配置

在项目中创建application.yaml文件,配置启动分支以dev分支启动。

SpringBoot集成nacos实现统一配置中心

再次启动项目,除了之前based on dataId[demo] ,我们看到控制台上显示:based on dataId[demo-dev.properties] 。这就说明nacos除了刚才加载的dataId=demo.properties文件,另外还根据启动分支,也尝试去读取 

${spring.application.name}-${启动分支}.${spring.cloud.nacos.config.fileExtension} ,即demo-dev.properties文件。

SpringBoot集成nacos实现统一配置中心

于是我们顺水推舟,在nacos上创建dataId为[demo-dev.properties] ,同时配置GroupId为dev,如下图,切记别忘了配置分组!!!

配置的内容就配一个 age=26 吧。兄弟,看这里,别漏了age变量的配置,下面做测试要用到的哦。

SpringBoot集成nacos实现统一配置中心

 返回并查看,现在就有两个配置了。

SpringBoot集成nacos实现统一配置中心

代码验证

我们写一个Controller试试看,这里代码中需要加上 @RefreshScope 注解,注解作用就是当nacos中的配置文件更新的时候,同步更新到代码中!!!  启动后不要关闭项目哈!

@RestController
@RequestMapping(value = "/")
@RefreshScope
public class HelloController {

    @Value("${author}")
    private String author; // 在demo.properties文件中配置了
    @Value("${age}")
    private String age; // 在demo-dev.properties文件中配置了

    @GetMapping(value = "/hello")
    public String function() {
        return "hello " + author + ",your age is " + age;
    }
}

看我的调用效果:

SpringBoot集成nacos实现统一配置中心

配置文件动态刷新

刚才启动的项目先不要关闭,我们接着在nacos上编辑demo-dev.properties文件,我们尝试修改age值

SpringBoot集成nacos实现统一配置中心

改成18岁,然后点击"发布"按钮,相当于重新刷新一下配置的值。

SpringBoot集成nacos实现统一配置中心

重新发布后,控制台上打印出 Refresh keys changed: [age] ,说明重新刷新了age的值。

SpringBoot集成nacos实现统一配置中心

再次访问,值就已经刷新啦!

 SpringBoot集成nacos实现统一配置中心

更多的配置文件

目前我们的应用可以读取demo.properties文件与demo-dev.properties文件,如果想把更多的配置文件加入到nacos中,应该怎么读取呢?

假设我们有一个数据库的配置要抽出来单独放到 database.yaml中。我们可以这样配。

在nacos中增加一个database.yaml的配置,如下图。

SpringBoot集成nacos实现统一配置中心

database.yaml的配置内容如下:

spring:
  datasource:
    mysql:
      driver-class-name: com.mysql.cj.jdbc.Driver

既然是yaml格式,那么在配置的时候,配置格式选择"yaml"。 为了测试,我们把Group设计为"common"。因为有同学可能会问Group一定要为"dev"吗。我的答案是dev开发环境最好设计为"dev"。这里为了测试,所以才设置的是"Group=common"。

SpringBoot集成nacos实现统一配置中心

配置好了以后,怎么让项目启动的时候读取除了刚才的demo.properties以及demo-dev.properties,怎么额外读取这个database.yaml,且分组是common的配置文件呢?

我们在bootstrap.properties文件中追加这段配置。

#额外的配置文件
#额外的第一个配置文件的dataId
spring.cloud.nacos.config.extension-configs[0].data-id=database.yaml
#额外的第一个配置文件的分组
spring.cloud.nacos.config.extension-configs[0].group=common
#开启自动刷新
spring.cloud.nacos.config.extension-configs[0].refresh=true


#额外的第二个配置文件只需要改变角标即可
#spring.cloud.nacos.config.extension-configs[1].data-id=xxxx
#spring.cloud.nacos.config.extension-configs[1].group=xxxx
#spring.cloud.nacos.config.extension-configs[1].refresh=true

#额外的第三个配置文件
#spring.cloud.nacos.config.extension-configs[2].data-id=xxxx
#spring.cloud.nacos.config.extension-configs[2].group=xxxx
#spring.cloud.nacos.config.extension-configs[2].refresh=true

#更多额外的配置文件....

SpringBoot集成nacos实现统一配置中心

测试Controller代码如下:

@RestController
@RequestMapping(value = "/")
@RefreshScope
public class DBController {

    @Value("${spring.datasource.mysql.driver-class-name}")
    private String driver;

    @GetMapping(value = "/db")
    public String function() {
        return driver;
    }
}

 浏览器访问查看,localhost:8081/db ,读取到了我们在nacos中的database.yaml中的${spring.datasource.mysql.driver-class-name} 配置的值。嘎嘎。

 SpringBoot集成nacos实现统一配置中心

总结 

你真是太棒啦!这是伟大的第一步,我们终于成功入门了nacos!

你看我都这么努力的分享知识给你了,鼓励一下又何妨O(∩_∩)O

大宇期待与你们共同进步!同时也非常感谢最近兄弟们的支持!

 SpringBoot集成nacos实现统一配置中心               SpringBoot集成nacos实现统一配置中心    

版权声明:程序员胖胖胖虎阿 发表于 2022年10月5日 上午4:32。
转载请注明:SpringBoot集成nacos实现统一配置中心 | 胖虎的工具箱-编程导航

相关文章

暂无评论

暂无评论...