别再到处乱放配置文件了！试试我司使用 7 年的这套解决方案，稳的一秕

举报
民工哥 发表于 2022/07/24 22:58:25 2022/07/24
【摘要】 点击下方“Java编程鸭”关注并标星 更多精彩 第一时间直达 1 简述 官方文档对Spring Cloud Config的描述如下： Spring Cloud Config为分布式系统中的外部配置提供服务器和客户端支持，使用Config Server，您可以在所有环境中管理应用程序的外部属性。客户端和服务器上的概念映...

点击下方“Java编程鸭”关注并标星

更多精彩 第一时间直达

1 简述

官方文档对Spring Cloud Config的描述如下：

Spring Cloud Config为分布式系统中的外部配置提供服务器和客户端支持，使用Config Server，您可以在所有环境中管理应用程序的外部属性。客户端和服务器上的概念映射与Spring Environment和PropertySource抽象相同。

因此它们与Spring应用程序非常契合，但可以与任何以任何语言运行的应用程序一起使用。随着应用程序通过从开发人员到测试和生产的部署流程，您可以管理这些环境之间的配置，并确定应用程序具有迁移时需要运行的一切。

服务器存储后端的默认实现使用git，因此它轻松支持标签版本的配置环境，以及可以访问用于管理内容的各种工具。很容易添加替代实现，并使用Spring配置将其插入。

1.1 配置中心存在的意义

一个应用中不只是代码，还需要连接资源和其它应用，经常有很多需要外部设置的项去调整应用行为，如切换不同的数据库，设置功能开关等。

随着系统微服务的不断增加，首要考虑的是系统的可伸缩、可扩展性好，随之就是一个配置管理的问题。各自管各自的开发时没什么问题，到了线上之后管理就会很头疼，到了要大规模更新就更烦了。

而且你不可能停止你的服务集群去更新的你配置，这是不现实的做法，因此Spring Cloud配置中心就是一个比较好的解决方案，下图就是一个Spring Cloud配置中心的解决方案：

7b59e14b4f3bd3f20af91bebb9a4d761.png

架构图如下：

75143bd1b1f26c207dcf394b961719dc.png

常见的配置中心的实现方法有：

  • 硬编码（缺点：需要修改代码，风险大）

  • 放在xml等配置文件中，和应用一起打包（缺点：需要重新打包和重启）

  • 文件系统中（缺点：依赖操作系统等）

  • 环境变量（缺点：有大量的配置需要人工设置到环境变量中，不便于管理且依赖平台）

  • 云端存储（缺点：与其他应用耦合）

Spring Cloud Config就是云端存储配置信息的，它具有中心化、版本控制、支持动态更新、平台独立、语言独立等特性。其特点是：

  • 提供服务端和客户端支持（spring cloud config server和spring cloud config client）

  • 集中式管理分布式环境下的应用配置

  • 基于Spring环境，无缝与Spring应用集成

  • 可用于任何语言开发的程序

  • 默认实现基于git仓库，可以进行版本管理

  • 可替换自定义实现

1.1.1 Spring Cloud Config包括两部分

1、Spring Cloud Config Server作为配置中心的服务端：

  • 拉取配置时更新git仓库副本，保证是最新结果

  • 支持数据结构丰富，yml、json、properties 等

  • 配合 eureke 可实现服务发现，配合 cloud bus 可实现配置推送更新

  • 配置存储基于 git仓库，可进行版本管理

  • 简单可靠，有丰富的配套方案

2、Spring Cloud Config Client客户端：

Spring Boot项目不需要改动任何代码，加入一个启动配置文件指明使用ConfigServer上哪个配置文件即可

1.1.2 SpringCloud Config与百度的disconf之类注册中心区别

主要区别在于下面三点：

1、配置的存储方式不同： disconf是把配置信息保存在mysql、zookeeper中，而spring cloud config是将配置保存在git/svn上 （即：配置当成源代码一样管理）

2、配置的管理方式不同： spring cloud config没有类似disconf的统一管理界面，既然把配置都当成git之类的源码来看待了，git的管理界面，就是配置的管理界面

3、配置变化的通知机制不同： disconf中配置变化后，依赖zk的事件watcher来通知应用，而spring cloud config则是依赖git每次push后，触发webhook回调，最终触发spring cloud bus(消息总线），然后由消息总线通知相关的应用。

从配置变化的通知机制上看，如果有100个应用节点，都依赖于统一配置，如果修改了配置，只想让某几个节点"灰度"更新配置，spring cloud config server更容易做到，这一点相对disconf更灵活

1.2 代码示例

目前SpringCloud Config的使用主要是通过Git/SVN方式做一个配置中心，然后每个服务从其中获取自身配置所需的参数。SpringCloud Config也支持本地参数配置的获取。

如果使用本地存储的方式，在application.properties 或application.yml 文件添加 spring.profiles.active=native 配置即可，它会从项目的 resources路径下读取配置文件。如果是读取指定的配置文件，那么可以使用 spring.cloud.config.server.native.searchLocations = file:D:/properties/来读取。

1.2.1 服务端

首先是服务端这块，首先创建一个注册中心，为了进行区分，创建一个springcloud-config-eureka的项目。

application.properties配置信息：

配置信息：


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       spring.application.name=springcloud-hystrix-eureka-server
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       server.port=8005
      
    
     
    3. 
    
  3. 
     
    
      
    
     
    
     
    
      
    
       eureka.client.register-with-eureka=false
      
    
     
    4. 
    
  4. 
     
    
      
    
     
    
     
    
      
    
       eureka.client.fetch-registry=false
      
    
     
    5. 
    
  5. 
     
    
      
    
     
    
     
    
      
    
       eureka.client.serviceUrl.defaultZone=http://localhost:8005/eureka/
      
    
     
    6.

配置说明：

  • spring.application.name： 这个是指定服务名称

  • server.port： 服务指定的端口

  • eureka.client.register-with-eureka： 表示是否将自己注册到Eureka Server，默认是true

  • eureka.client.fetch-registry： 表示是否从Eureka Server获取注册信息，默认为true

  • eureka.client.serviceUrl.defaultZone： 这个是设置与Eureka Server交互的地址，客户端的查询服务和注册服务都需要依赖这个地址

服务端这边只需要在SpringBoot启动类添加@EnableEurekaServer注解就可以了，该注解表示此服务是一个服务注册中心服务。

代码示例：


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       @SpringBootApplication
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       @EnableEurekaServer
      
    
     
    3. 
    
  3. 
     
    
      
    
     
    
     
    
      
    
       public class ConfigEurekaApplication {
      
    
     
    4. 
    
  4. 
     
    
      
    
     
    
     
    
      
     
      
    
     
    5. 
    
  5. 
     
    
      
    
     
    
     
    
      
    
        public static void main(String[] args) {
      
    
     
    6. 
    
  6. 
     
    
      
    
     
    
     
    
      
    
         SpringApplication.run(ConfigEurekaApplication.class, args);
      
    
     
    7. 
    
  7. 
     
    
      
    
     
    
     
    
      
    
          System.out.println("config 注册中心服务启动...");
      
    
     
    8. 
    
  8. 
     
    
      
    
     
    
     
    
      
    
        }
      
    
     
    9. 
    
  9. 
     
    
      
    
     
    
     
    
      
    
       }
      
    
     
    10.

创建好了注册中心之后，我们再来创建一个配置中心，用于管理配置。

创建一个springcloud-config-server的项目。然后在application.properties配置文件添加如下配置：

配置信息：


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       spring.application.name=springcloud-config-server
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       server.port=9005
      
    
     
    3. 
    
  3. 
     
    
      
    
     
    
     
    
      
    
       eureka.client.serviceUrl.defaultZone=http://localhost:8005/eureka/
      
    
     
    4. 
    
  4. 
     
    
      
    
     
    
     
    
      
    
       spring.cloud.config.server.git.uri = https://github.com/xuwujing/springcloud-study/
      
    
     
    5. 
    
  5. 
     
    
      
    
     
    
     
    
      
    
       spring.cloud.config.server.git.search-paths = /springcloud-config/config-repo
      
    
     
    6. 
    
  6. 
     
    
      
    
     
    
     
    
      
    
       spring.cloud.config.server.git.username = 
      
    
     
    7. 
    
  7. 
     
    
      
    
     
    
     
    
      
    
       spring.cloud.config.server.git.password =
      
    
     
    8.

配置说明：

  • spring.application.name： 这个是指定服务名称

  • server.port：服务指定的端口

  • eureka.client.serviceUrl.defaultZone： 这个是设置与Eureka Server交互的地址，客户端的查询服务和注册服务都需要依赖这个地址

  • spring.cloud.config.server.git.uri： 配置的Git仓库的地址

  • spring.cloud.config.server.git.search-paths： git仓库地址下的相对地址 多个用逗号","分割

  • spring.cloud.config.server.git.username： git仓库的账号

  • spring.cloud.config.server.git.password： git仓库的密码

注：如果想使用本地方式读取配置信息，那么只需将spring.cloud.config.server.git的配置改成spring.profiles.active=native，然后在resources路径下新增一个文件即可。

这里为了进行本地配置文件测试，新建一个configtest.properties配置文件，添加如下内容:

word=hello world

代码这块也很简单，在程序主类中，额外添加@EnableConfigServer注解，该注解表示启用config配置中心功能。代码如下:


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       @EnableDiscoveryClient
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       @EnableConfigServer
      
    
     
    3. 
    
  3. 
     
    
      
    
     
    
     
    
      
    
       @SpringBootApplication
      
    
     
    4. 
    
  4. 
     
    
      
    
     
    
     
    
      
    
       public class ConfigServerApplication {
      
    
     
    5. 
    
  5. 
     
    
      
    
     
    
     
    
      
     
      
    
     
    6. 
    
  6. 
     
    
      
    
     
    
     
    
      
    
        public static void main(String[] args) {
      
    
     
    7. 
    
  7. 
     
    
      
    
     
    
     
    
      
    
         SpringApplication.run(ConfigServerApplication.class, args);
      
    
     
    8. 
    
  8. 
     
    
      
    
     
    
     
    
      
    
         System.out.println("配置中心服务端启动成功!");
      
    
     
    9. 
    
  9. 
     
    
      
    
     
    
     
    
      
    
        }
      
    
     
    10. 
    
  10. 
     
    
      
    
     
    
     
    
      
    
       }
      
    
     
    11.

完成上述代码之后，我们的配置中心服务端已经构建完成了。

1.2.2 客户端

我们新建一个springcloud-config-client的项目，用于做读取配置中心的配置。pom依赖还是和配置中心一样，不过需要新增一个配置，用于指定配置的读取。

创建一个bootstrap.properties文件，并添加如下信息:

配置信息：


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       spring.cloud.config.name=configtest
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       spring.cloud.config.profile=pro
      
    
     
    3. 
    
  3. 
     
    
      
    
     
    
     
    
      
    
       spring.cloud.config.label=master
      
    
     
    4. 
    
  4. 
     
    
      
    
     
    
     
    
      
    
       spring.cloud.config.discovery.enabled=true
      
    
     
    5. 
    
  5. 
     
    
      
    
     
    
     
    
      
    
       spring.cloud.config.discovery.serviceId=springcloud-config-server
      
    
     
    6. 
    
  6. 
     
    
      
    
     
    
     
    
      
    
       eureka.client.serviceUrl.defaultZone=http://localhost:8005/eureka/
      
    
     
    7.

配置说明：

  • spring.cloud.config.name： 获取配置文件的名称

  • spring.cloud.config.profile： 获取配置的策略

  • spring.cloud.config.label： 获取配置文件的分支，默认是master。如果是是本地获取的话，则无用

  • spring.cloud.config.discovery.enabled： 开启配置信息发现

  • spring.cloud.config.discovery.serviceId： 指定配置中心的service-id，便于扩展为高可用配置集群

  • eureka.client.serviceUrl.defaultZone： 这个是设置与Eureka Server交互的地址，客户端的查询服务和注册服务都需要依赖这个地址

注：上面这些与spring-cloud相关的属性必须配置在bootstrap.properties中，config部分内容才能被正确加载。因为bootstrap.properties的相关配置会先于application.properties，而bootstrap.properties的加载也是先于application.properties。需要注意的是eureka.client.serviceUrl.defaultZone要配置在bootstrap.properties，不然客户端是无法获取配置中心参数的，会启动失败！

application.properties配置


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       spring.application.name=springcloud-config-client
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       server.port=9006
      
    
     
    3.

配置说明：


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       spring.application.name： 这个是指定服务名称
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       server.port:服务指定的端口
      
    
     
    3.

程序主类代码，和之前的基本一致。代码如下:

代码示例：


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       @EnableDiscoveryClient
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       @SpringBootApplication
      
    
     
    3. 
    
  3. 
     
    
      
    
     
    
     
    
      
    
       public class ConfigClientApplication {
      
    
     
    4. 
    
  4. 
     
    
      
    
     
    
     
    
      
     
      
    
     
    5. 
    
  5. 
     
    
      
    
     
    
     
    
      
    
        public static void main(String[] args) {
      
    
     
    6. 
    
  6. 
     
    
      
    
     
    
     
    
      
    
         SpringApplication.run(ConfigClientApplication.class, args);
      
    
     
    7. 
    
  7. 
     
    
      
    
     
    
     
    
      
    
         System.out.println("配置中心客户端启动成功!");
      
    
     
    8. 
    
  8. 
     
    
      
    
     
    
     
    
      
    
        }
      
    
     
    9. 
    
  9. 
     
    
      
    
     
    
     
    
      
    
       }
      
    
     
    10.

为了方便查询，在控制中进行参数的获取，并返回。@Value注解是默认是从application.properties配置文件获取参数，但是这里我们在客户端并没有进行配置，该配置在配置中心服务端，我们只需指定好了配置文件之后即可进行使用。

代码示例：


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       @RestController
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       public class ClientController {
      
    
     
    3. 
    
  3. 
     
    
      
    
     
    
     
    
      
    
        
      
    
     
    4. 
    
  4. 
     
    
      
    
     
    
     
    
      
    
        @Value("${word}")
      
    
     
    5. 
    
  5. 
     
    
      
    
     
    
     
    
      
    
        private String word;
      
    
     
    6. 
    
  6. 
     
    
      
    
     
    
     
    
      
    
        
      
    
     
    7. 
    
  7. 
     
    
      
    
     
    
     
    
      
    
           @RequestMapping("/hello")
      
    
     
    8. 
    
  8. 
     
    
      
    
     
    
     
    
      
    
           public String index(@RequestParam String name) {
      
    
     
    9. 
    
  9. 
     
    
      
    
     
    
     
    
      
    
               return name+","+this.word;
      
    
     
    10. 
    
  10. 
     
    
      
    
     
    
     
    
      
    
           }
      
    
     
    11. 
    
  11. 
     
    
      
    
     
    
     
    
      
    
       }
      
    
     
    12.

到此，客户端项目也就构建完成了。

1.2.3 功能测试

完成如上的工程开发之后，我们来进行测试。

1.2.3.1 本地测试

首先我们把springcloud-config-server项目的application.properties配置文件添加spring.profiles.active=native配置，注释掉spring.cloud.config.server.git相关的配置，然后在src/main/resources目录下新建一个configtest.properties文件，然后在里面添加一个配置word=hello world。

添加完成之后，我们依次启动springcloud-config-eureka、springcloud-config-server、springcloud-config-client这三个项目。启动成功之前，先看来看看配置中心服务端的配置文件获取，在浏览器输入:

http://localhost:9005/configtest-1.properties

查看该文件的配置信息。

注：配置文件的名称是configtest.properties，但是如果直接该名称的话是获取不到的，因为在配置文件名需要通过-来进行获取，如果配置文件名称没有-，那么添加了-之后，会自动进行匹配搜索。

springcloud config的URL与配置文件的映射关系如下:


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       /{application}/{profile}[/{label}]
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       /{application}-{profile}.yml
      
    
     
    3. 
    
  3. 
     
    
      
    
     
    
     
    
      
    
       /{label}/{application}-{profile}.yml
      
    
     
    4. 
    
  4. 
     
    
      
    
     
    
     
    
      
    
       /{application}-{profile}.properties
      
    
     
    5. 
    
  5. 
     
    
      
    
     
    
     
    
      
    
       /{label}/{application}-{profile}.properties
      
    
     
    6.

上面的url会映射{application}-{profile}.properties对应的配置文件，{label}对应git上不同的分支，默认为master。

界面返回：

word: hello world

然后调用客户端的接口，查看是否能够获取配置信息。在浏览器上输入：

http://localhost:9006//hello?name=pancm

界面返回：

pancm,hello world

示例图：

812e6f76afb06c8117249d53bcd94bd0.png b87002f48b0463174221d8a2cca52551.png
1.2.3.2 Git测试

在完成本地测试之后，我们把这个spring.profiles.active=native配置注释掉，解除spring.cloud.config.server.git相关的注释(账号和密码要填写真实的)，然后在git仓库上建立一个config-repo文件夹，新建configtest-pro.properties、configtest-dev.properties两个配置，这两个的配置分别是word=hello world！！和word=hello world！， 然后和configtest.properties配置文件一起上传到config-repo文件夹中。

首先在浏览器输入：

http://localhost:9005/configtest-dev.properties

浏览器返回：

word: hello world!

然后再浏览器输入:

http://localhost:9005/configtest-pro.properties

浏览器返回:

word: hello world!!

上传了configtest.properties文件，但是这个文件名称没有-，我们想获取其中参数的信息的话，可以在然后-随意添加一个参数，它会自动进行匹配，在浏览器输入：

http://localhost:9005/configtest-1.properties

浏览器返回：

word: hello world

然后进行客户端接口调用测试，在浏览器输入：

http://localhost:9006/hello?name=pancm

浏览器返回：

pancm,Hello World!!

由于这里我配置的前缀是 pro ，所以读取的是configtest-pro.properties文件的数据，想要获取其他的配置，修改spring.cloud.config.profile配置即可。

示例图：

2ee168269759ad87580f0c6009243002.png

来源：blog.csdn.net/weixin_42039228/article

/details/123786902

END


   
    
    
  1. 
     
    
      
    
     
    
     
    
      
    
       看完本文有收获？请转发分享给更多人
      
    
     
    2. 
    
  2. 
     
    
      
    
     
    
     
    
      
    
       关注「Java编程鸭」，提升Java技能
      
    
     
    3. 
    
  3. 
     
    
      
    
     
    
     
    
      
    
       关注Java编程鸭微信公众号，后台回复：码农大礼包 可以获取最新整理的技术资料一份。涵盖Java 框架学习、架构师学习等！
      
    
     
    4. 
    
  4. 
     
    
      
    
     
    
     
    
      
     
      
    
     
    5. 
    
  5. 
     
    
      
    
     
    
     
    
      
     
      
    
     
    6. 
    
  6. 
     
    
      
    
     
    
     
    
      
    
       文章有帮助的话，在看，转发吧。
      
    
     
    7. 
    
  7. 
     
    
      
    
     
    
     
    
      
    
       谢谢支持哟 (*^__^*）
      
    
     
    8.

文章来源: mingongge.blog.csdn.net，作者：民工哥，版权归原作者所有，如需转载，请联系作者。

原文链接：mingongge.blog.csdn.net/article/details/125954762

【版权声明】本文为华为云社区用户转载文章，如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱： cloudbbs@huaweicloud.com
Git Spring
  • 点赞
  • 收藏
  • 关注作者

评论（0）

0/1000
抱歉，系统识别当前为高风险访问，暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称，即可参与社区互动！

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

确认 取消

加入云驻计划，成为创作者

  • 华为云周边好礼
  • 免费体验产品
  • 特殊身份标识
  • 线下官方门票
  • 内部专家零距离
  • 与10000+优质创作者共同成长
立即加入