SpringCloud学习系列之四-----配置中心(Config)使用详解

时间:2025-03-27 17:36:01

前言

本篇主要介绍的是SpringCloud中的分布式配置中心(SpringCloud Config)的相关使用教程。

SpringCloud Config

Config 介绍

Spring Cloud Config项目是一个解决分布式系统的配置管理方案。它包含了Client和Server两个部分,server提供配置文件的存储、以接口的形式将配置文件的内容提供出去,client通过接口获取数据、并依据此数据初始化自己的应用。

开发准备

开发环境

  • JDK:1.8
  • SpringBoot:2.1.
  • SpringCloud:Finchley

注:不一定非要用上述的版本,可以根据情况进行相应的调整。需要注意的是以后,jdk的版本必须是1.8以上!

确认了开发环境之后,我们再来添加相关的pom依赖。

<dependencies>
   	<dependency>
		<groupId></groupId>
		<artifactId>spring-cloud-config</artifactId>
	</dependency>
	<dependency>
		<groupId></groupId>
		<artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
	</dependency>
</dependencies>
复制代码

SpringCloud Config 示例

目前SpringCloud Config的使用主要是通过Git/SVN方式做一个配置中心,然后每个服务从其中获取自身配置所需的参数。SpringCloud Config也支持本地参数配置的获取。如果使用本地存储的方式,在 文件添加 =native 配置即可,它会从项目的 resources路径下读取配置文件。如果是读取指定的配置文件,那么可以使用 = file:D:/properties/ 来读取。

服务端

首先是服务端这块,首先创建一个注册中心,为了进行区分,创建一个springcloud-config-eureka的项目。 代码和配置和之前的基本一样。 配置信息:

配置信息:

=springcloud-hystrix-eureka-server
=8005
-with-eureka=false
-registry=false
=http://localhost:8005/eureka/
复制代码

配置说明:

  • : 这个是指定服务名称。
  • :服务指定的端口。
  • -with-eureka:表示是否将自己注册到Eureka Server,默认是true。
  • -registry:表示是否从Eureka Server获取注册信息,默认为true。
  • : 这个是设置与Eureka Server交互的地址,客户端的查询服务和注册服务都需要依赖这个地址。

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

代码示例:


	@SpringBootApplication
	@EnableEurekaServer
	public class ConfigEurekaApplication {
	
		public static void main(String[] args) {
			(, args);
			 ("config 注册中心服务启动...");
		}
	}


复制代码

创建好了注册中心之后,我们再来创建一个配置中心,用于管理配置。 创建一个springcloud-config-server的项目。然后在配置文件添加如下配置:

配置信息:

 =springcloud-config-server
 =9005
 =http://localhost:8005/eureka/
  = /xuwujing/springcloud-study/
 -paths = /springcloud-config/config-repo
  = 
  = 
复制代码

配置说明:

  • : 这个是指定服务名称。
  • :服务指定的端口。
  • : 这个是设置与Eureka Server交互的地址,客户端的查询服务和注册服务都需要依赖这个地址。
  • : 配置的Git长裤的地址。
  • -paths: git仓库地址下的相对地址 多个用逗号","分割。
  • :git仓库的账号。
  • :git仓库的密码。

注:如果想使用本地方式读取配置信息,那么只需将的配置改成=native,然后在resources路径下新增一个文件即可。

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


    word=hello world

复制代码

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

、、、

@EnableDiscoveryClient
@EnableConfigServer
@SpringBootApplication
public class ConfigServerApplication {

	public static void main(String[] args) {
		(, args);
		("配置中心服务端启动成功!");
	}
}
复制代码

、、、

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

客户端

我们新建一个springcloud-config-client的项目,用于做读取配置中心的配置。pom依赖还是和配置中心一样,不过需要新增一个配置,用于指定配置的读取。 创建一个文件,并添加如下信息:

配置信息:

=configtest
=pro
=master
=true
=springcloud-config-server
=http://localhost:8005/eureka/
复制代码

配置说明:

  • : 获取配置文件的名称。
  • : 获取配置的策略。
  • :获取配置文件的分支,默认是master。如果是是本地获取的话,则无用。
  • : 开启配置信息发现。
  • : 指定配置中心的service-id,便于扩展为高可用配置集群。
  • : 这个是设置与Eureka Server交互的地址,客户端的查询服务和注册服务都需要依赖这个地址。

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

配置

=springcloud-config-client
=9006
复制代码

配置说明:

  • : 这个是指定服务名称。
  • :服务指定的端口。

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

代码示例:


	@EnableDiscoveryClient
	@SpringBootApplication
	public class ConfigClientApplication {
	
		public static void main(String[] args) {
			(, args);
			("配置中心客户端启动成功!");
		}
	}

复制代码

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

代码示例:


	@RestController
	public class ClientController {
		
		@Value("${word}")
		private String word;
		
	    @RequestMapping("/hello")
	    public String index(@RequestParam String name) {
	        return name+","+;
	    }
	}

复制代码

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

功能测试

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

本地测试

首先我们把springcloud-config-server项目的配置文件添加=native配置,注释掉相关的配置,然后在src/main/resources目录下新建一个文件,然后在里面添加一个配置word=hello world。 添加完成之后,我们依次启动springcloud-config-eurekaspringcloud-config-serverspringcloud-config-client这三个项目。启动成功之前,先看来看看配置中心服务端的配置文件获取,在浏览器输入:

http://localhost:9005/

查看该文件的配置信息。

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

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

/{application}/{profile}[/{label}]
/{application}-{profile}.yml
/{label}/{application}-{profile}.yml
/{application}-{profile}.properties
/{label}/{application}-{profile}.properties
复制代码

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

界面返回:

word: hello world
复制代码

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

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

界面返回:

pancm,hello world
复制代码

示例图:

Git测试

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

首先在浏览器输入:

http://localhost:9005/

浏览器返回:

word: hello world!
复制代码

然后再浏览器输入:

http://localhost:9005/

浏览器返回:

word: hello world!!
复制代码

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

http://localhost:9005/

浏览器返回:

word: hello world
复制代码

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

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

浏览器返回:

pancm,Hello World!!
复制代码

由于这里我配置的前缀是 pro ,所以读取的是 文件的数据,想要获取其他的配置,修改配置即可。

示例图:

其他

项目地址

基于、SpringCloud的Finchley版本开发的地址:/xuwujing/sp…

基于、SpringCloud 的Dalston版本开发的地址: /xuwujing/sp…

如果感觉项目不错,希望能给个star,谢谢!

音乐推荐

原创不易,如果感觉不错,希望留言推荐!您的支持是我写作的最大动力! 版权声明: 作者:虚无境 博客园出处:/xuwujing ****出处:/qazwsxpcm     个人博客出处: