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

时间  2019-11-21 标签 spring cloud alibaba 基础 教程 使用 nacos 做为 配置 中心

经过本教程的前两篇：html

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

简介

Nacos除了实现了服务的注册发现以外，还将配置中心功能整合在了一块儿。经过Nacos的配置管理功能，咱们能够将整个架构体系内的全部配置都集中在Nacos中存储。这样作的好处，在以往的教程中介绍Spring Cloud Config时也有提到，主要有如下几点：git

  • 分离的多环境配置，能够更灵活的管理权限，安全性更高
  • 应用程序的打包更为纯粹，以实现一次打包，多处运行的特色（《云原声应用的12要素》之一）

Nacos的配置管理模型与淘宝开源的配置中心Diamond相似，基础层面都经过DataId和Group来定位配置内容，除此以外还增长了不少其余的管理功能。github

快速入门

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

建立配置

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

clipboard.png

其中：bootstrap

  • 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，加入必要的依赖配置，好比：bash

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.0.5.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>Finchley.SR1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>0.2.1.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    </dependency>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.2</version>
        <optional>true</optional>
    </dependency>
</dependencies>

上述内容主要三部分：架构

  • 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，在用到这个配置的应用中，也自动刷新了这个配置信息。

参考资料

代码示例

本文示例读者能够经过查看下面仓库的中的alibaba-nacos-config-client项目：

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

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

联系我们 沪ICP备13005482号-10