Spring Cloud Alibaba基础教程：使用Nacos作为配置中心

CHENGKANG 发布于2019-06-24 18:19 / 2276人阅读

摘要：通过本教程的前两篇基础教程使用实现服务注册与发现基础教程支持的几种服务消费方式我们已经学会了，如何利用实现服务的注册与发现。简介除了实现了服务的注册发现之外，还将配置中心功能整合在了一起。同时，值必须与上一阶段中创建的配置匹配除了或者后缀。

通过本教程的前两篇：

《Spring Cloud Alibaba基础教程：使用Nacos实现服务注册与发现》

《Spring Cloud Alibaba基础教程：支持的几种服务消费方式（RestTemplate、WebClient、Feign）》

我们已经学会了，如何利用Nacos实现服务的注册与发现。同时，也介绍了在Spring Cloud中，我们可以使用的几种不同编码风格的服务消费方式。接下来，我们再来一起学习一下Nacos的另外一个重要能力：配置管理。

简介

Nacos除了实现了服务的注册发现之外，还将配置中心功能整合在了一起。通过Nacos的配置管理功能，我们可以将整个架构体系内的所有配置都集中在Nacos中存储。这样做的好处，在以往的教程中介绍Spring Cloud Config时也有提到，主要有以下几点：

分离的多环境配置，可以更灵活的管理权限，安全性更高

应用程序的打包更为纯粹，以实现一次打包，多处运行的特点（《云原声应用的12要素》之一）

Nacos的配置管理模型与淘宝开源的配置中心Diamond类似，基础层面都通过DataId和Group来定位配置内容，除此之外还增加了很多其他的管理功能。

快速入门

下面我们通过一个简单的例子来介绍如何在Nacos中创建配置内容以及如何在Spring Cloud应用中加载Nacos的配置信息。

创建配置

第一步：进入Nacos的控制页面，在配置列表功能页面中，点击右上角的“+”按钮，进入“新建配置”页面，如下图填写内容：

其中：

Data ID：填入alibaba-nacos-config-client.properties

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

配置格式：选择Properties

配置内容：应用要加载的配置内容，这里仅作为示例，做简单配置，比如：didispace.title=spring-cloud-alibaba-learning

创建应用

第一步：创建一个Spring Boot应用，可以命名为：alibaba-nacos-config-client。

第二步：编辑pom.xml，加入必要的依赖配置，比如：


    org.springframework.boot
    spring-boot-starter-parent
    2.0.5.RELEASE
     



    
        
            org.springframework.cloud
            spring-cloud-dependencies
            Finchley.SR1
            pom
            import
        
        
            org.springframework.cloud
            spring-cloud-alibaba-dependencies
            0.2.1.RELEASE
            pom
            import
        
    



    
        org.springframework.boot
        spring-boot-starter-web
    
    
        org.springframework.cloud
        spring-cloud-starter-alibaba-nacos-config
    
    
        org.projectlombok
        lombok
        1.18.2
        true

上述内容主要三部分：

parent：定义spring boot的版本

dependencyManagement：spring cloud的版本以及spring cloud alibaba的版本，由于spring cloud alibaba还未纳入spring cloud的主版本管理中，所以需要自己加入

dependencies：当前应用要使用的依赖内容。这里主要新加入了Nacos的配置客户端模块：spring-cloud-starter-alibaba-nacos-config。由于在dependencyManagement中已经引入了版本，所以这里就不用指定具体版本了。

可以看到，这个例子中并没有加入nacos的服务发现模块，所以这两个内容是完全可以独立使用的

第三步：创建应用主类，并实现一个HTTP接口：

@SpringBootApplication
public class TestApplication {

    public static void main(String[] args) {
        SpringApplication.run(TestApplication.class, args);
    }

    @Slf4j
    @RestController
    @RefreshScope
    static class TestController {

        @Value("${didispace.title:}")
        private String title;

        @GetMapping("/test")
        public String hello() {
            return title;
        }

    }

}

内容非常简单，@SpringBootApplication定义是个Spring Boot应用；还定义了一个Controller，其中通过@Value注解，注入了key为didispace.title的配置（默认为空字符串），这个配置会通过/test接口返回，后续我们会通过这个接口来验证Nacos中配置的加载。另外，这里还有一个比较重要的注解@RefreshScope，主要用来让这个类下的配置内容支持动态刷新，也就是当我们的应用启动之后，修改了Nacos中的配置内容之后，这里也会马上生效。

第四步：创建配置文件bootstrap.properties，并配置服务名称和Nacos地址

spring.application.name=alibaba-nacos-config-client
server.port=8001

spring.cloud.nacos.config.server-addr=127.0.0.1:8848

注意：这里必须使用bootstrap.properties。同时，spring.application.name值必须与上一阶段Nacos中创建的配置Data Id匹配（除了.properties或者.yaml后缀）。

第五步：启动上面创建的应用。

2019-01-27 18:29:43.497  INFO 93597 --- [           main] o.s.c.a.n.c.NacosPropertySourceBuilder   : Loading nacos data, dataId: "alibaba-nacos-config-client.properties", group: "DEFAULT_GROUP"
2019-01-27 18:29:43.498  INFO 93597 --- [           main] b.c.PropertySourceBootstrapConfiguration : Located property source: CompositePropertySource {name="NACOS", propertySources=[NacosPropertySource {name="alibaba-nacos-config-client.properties"}]}

在启动的时候，我们可以看到类似上面的日志信息，这里会输出应用程序要从Nacos中获取配置的dataId和group。如果在启动之后，发现配置信息没有获取到的时候，可以先从这里着手，看看配置加载的目标是否正确。

第六步：验证配置获取和验证动态刷新

用curl或者postman等工具，访问接口: localhost:8001/test，一切正常的话，将返回Nacos中配置的spring-cloud-alibaba-learning。然后，再通过Nacos页面，修改这个内容，点击发布之后，再访问接口，可以看到返回结果变了。

同时，在应用的客户端，我们还能看到如下日志：

2019-01-27 18:39:14.162  INFO 93597 --- [-127.0.0.1_8848] o.s.c.e.event.RefreshEventListener       : Refresh keys changed: [didispace.title]

在Nacos中修改了Key，在用到这个配置的应用中，也自动刷新了这个配置信息。

参考资料

Nacos官方文档

Nacos源码分析

代码示例

本文示例读者可以通过查看下面仓库的中的alibaba-nacos-config-client项目：

Github：https://github.com/dyc87112/SpringCloud-Learning/

Gitee：https://gitee.com/didispace/SpringCloud-Learning/

如果您对这些感兴趣，欢迎star、follow、收藏、转发给予支持！

以下专题教程也许您会有兴趣

Spring Boot基础教程

Spring Cloud基础教程

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/11978.html

公益：开放一台Nacos服务端给各位Spring Cloud爱好者

摘要：之前开放过一台公益给大家，以方便大家在阅读我博客中教程时候做实验。由于目前在连载，所以对应的也部署了一台，并且也开放出来，给大家学习测试之用。之前开放过一台公益Eureka Server给大家，以方便大家在阅读我博客中教程时候做实验。由于目前在连载Spring Cloud Alibaba，所以对应的也部署了一台Nacos，并且也开放出来，给大家学习测试之用。 Nacos控制台 ...

jk_v1 2019-08-19 11:41 评论0 收藏0
Spring Cloud Alibaba基础教程：Nacos的数据持久化

摘要：在搭建集群之前，我们需要先修改的数据持久化配置为存储。所以，如果启动多个默认配置下的节点，数据存储是存在一致性问题的。为了解决这个问题，采用了集中式存储的方式来支持集群化部署，目前只要支持的存储。前情回顾：《Spring Cloud Alibaba基础教程：使用Nacos实现服务注册与发现》《Spring Cloud Alibaba基础教程：支持的几种服务消费方式》《Spri...

endiat 2019-08-16 15:09 评论0 收藏0
Spring Cloud Alibaba基础教程：Nacos配置的多环境管理

摘要：第二步在应用的配置文件中，增加环境配置第三步启动应用，我们可以看到日志中打印了，加载的配置文件使用实现在中是用来对做集合管理的重要概念。深入思考上面我们分别利用配置管理功能中的几个不同纬度来实现多环境的配置管理。前情回顾：《Spring Cloud Alibaba基础教程：使用Nacos实现服务注册与发现》《Spring Cloud Alibaba基础教程：支持的几种服务消费方...

CNZPH 2019-06-24 18:19 评论0 收藏0
Spring Cloud Alibaba基础教程：Nacos的集群部署

摘要：通过本文，我们将完成生产环境的搭建。第二步修改文件，增加支持数据源配置，添加目前只支持数据源的用户名和密码。另外，的集群需要个或个以上的节点，并且确保这三个节点之间是可以互相访问的。也可以故意的关闭某个实例，来验证集群是否还能正常服务。前情回顾：《Spring Cloud Alibaba基础教程：使用Nacos实现服务注册与发现》《Spring Cloud Alibaba基础教...

elarity 2019-08-16 15:15 评论0 收藏0
Spring Cloud Alibaba基础教程：Nacos的集群部署

摘要：通过本文，我们将完成生产环境的搭建。第二步修改文件，增加支持数据源配置，添加目前只支持数据源的用户名和密码。另外，的集群需要个或个以上的节点，并且确保这三个节点之间是可以互相访问的。也可以故意的关闭某个实例，来验证集群是否还能正常服务。前情回顾：《Spring Cloud Alibaba基础教程：使用Nacos实现服务注册与发现》《Spring Cloud Alibaba基础教...

godruoyi 2019-06-24 18:19 评论0 收藏0