前言
在 分布式系统 中,由于服务数量巨多,为了方便 服务配置文件 的 统一管理 和 实时更新,所以需要 分布式配置中心 组件。 Spring Cloud
提供的 分布式配置中心 组件是 Spring Cloud Config
,它支持将 配置服务 放在配置服务的 内存 中(即 本地),也支持放在 远程 Git
仓库中。Spring Cloud Config
提供了两个角色,其一是 Config Server
,其二是 Config Client
。
正文
1. Config Server从本地读取配置文件
创建一个新的 Spring Boot
项目模块,取名为 config-server
,它的 pom.xml
配置如下:
4.0.0
org.springframework.boot
spring-boot-starter-parent
1.5.3.RELEASE
io.github.ostenant.springcloud
config-server
0.0.1-SNAPSHOT
config-server
Demo project for Spring Boot
1.8
Dalston.RELEASE
org.springframework.cloud
spring-cloud-config-server
org.springframework.boot
spring-boot-starter-test
test
org.springframework.cloud
spring-cloud-dependencies
${spring-cloud.version}
pom
import
org.springframework.boot
spring-boot-maven-plugin
在应用启动类上使用 注解 @EnableConfigServer
开启 配置服务器。
@EnableConfigServer
@SpringBootApplication
public class ConfigServerApplication {
public static void main(String[] args) {
SpringApplication.run(ConfigServerApplication.class, args);
}
}
需要在程序的 配置文件 application.properties
里面进行如下配置。通过 spring.profile.active=native
来配置 Config Server
从 本地读取配置,读取的路径为 Classpath
下的 shared
目录。
server:
port: 8769
spring:
application:
name: config-server
profiles:
active: native
cloud:
config:
server:
native:
search-locations: classpath:/shared
在 src/main/resources
目录下新建 shared
文件夹,在 shared
文件夹下新建一个 config-client-dev.yml
文件。
server:
port: 8762
foo: foo version 1
运行 ConfigServerApplication
的 main()
方法,在 8769
端口启动 Config Server
应用程序。
2. 构建Config Client
创建一个 Spring Boot
项目模块,取名为 config-client
,它的 pom.xml
配置如下:
4.0.0
org.springframework.boot
spring-boot-starter-parent
1.5.3.RELEASE
io.github.ostenant.springcloud
config-client
0.0.1-SNAPSHOT
config-client
Demo project for Spring Boot
1.8
Dalston.RELEASE
org.springframework.cloud
spring-cloud-starter-config
org.springframework.boot
spring-boot-starter-web
org.springframework.boot
spring-boot-starter-test
test
org.springframework.cloud
spring-cloud-dependencies
${spring-cloud.version}
pom
import
org.springframework.boot
spring-boot-maven-plugin
在 resources
目录下新建 bootstrap.yml
文件,因为 bootstrap
相对于 application
具有 优先的执行顺序。
变量 {spring.application.name}
和 {spring.profiles.active}
,两者使用 “-”
相连,作为 Config Client
向 Config Server
读取的 配置文件名。
bootstrap.yml
spring:
application:
name: config-client
cloud:
config:
uri: http://localhost:8769
fail-fast: true # 读取没有成功,执行快速失败
profiles:
active: dev
配置一个接口,用于测试 读取配置文件 的 foo
变量,并通过 API
接口返回客户端。
@RestController
@SpringBootApplication
public class ConfigClientApplication {
public static void main(String[] args) {
SpringApplication.run(ConfigClientApplication.class, args);
}
@Value("${foo}")
private String foo;
@RequestMapping(value = "/foo")
public String foo(){
return foo;
}
}
启动 config-client
应用程序,访问 http://localhost:8762/foo
,服务端的响应数据如下:
foo version 1
可见 config-client
成功地从 config-server
项目的 shared
本地文件目录 读取到 配置文件 config-client-dev.yml
中的 foo
变量。
3. Config Server从远程Git仓库读取配置文件
修改 config-server
的配置文件 application.yml
,代码如下.
server:
port: 8769
spring:
application:
name: config-server
cloud:
config:
server:
git:
uri: https://coding.net/ostenant/config-repo
search-paths: test
username: [email protected]
password: xxxx
label: master
如果 Git
仓库为 公开仓库,可以不填写 用户名 和 密码;如果是 私有仓库 则需要填写,本例子配置了一个 私有仓库。
配置 | 解释 |
---|---|
spring.cloud.config.server.git.uri | 配置git仓库地址 |
spring.cloud.config.server.git.searchPaths | 配置仓库路径 |
spring.cloud.config.label | 配置仓库的分支 |
spring.cloud.config.server.git.username | 访问git仓库的用户名 |
spring.cloud.config.server.git.password | 访问git仓库的用户密码 |
远程仓库 https://coding.net/ostenant/config-repo
中有个 名为 config-client-dev.properties
的 配置文件,里面配置有一个属性:
foo = foo version 2
重新启动应用程序 config-server
和 config-client
,再次访问 http://localhost:8762/foo
,服务端的响应数据如下:
foo version 2
可见,config-server
从远程 Git
仓库读取了 配置文件,进一步 config-client
从 config-server
读取了相关的 配置属性。
4. 构建高可用的Config Server
将 配置中心 config-server
做成一个 微服务,并且将其 集群化,从而实现 高可用。
4.1. 改造Config Server
在 Config Server
中引入 Eureka
客户端的 起步依赖 spring-cloud-starter-eureka
。
org.springframework.cloud
spring-cloud-starter-eureka
在应用的 启动类 上加上 注解 @EnableEurekaClient
,将 Config Server
注册到 Eureka Server
上面。
在配置文件 application.yml
加入 服务注册地址:
eureka:
client:
service-url:
defaultZone: http://locahost:8761/eureka/
4.2. 改造Config Client
同样的在 Config Client
中引入 Eureka
客户端的 起步依赖 spring-cloud-starter-eureka
。
org.springframework.cloud
spring-cloud-starter-eureka
在应用的 启动类 上加上 注解 @EnableEurekaClient
,将 Config Client
注册到 Eureka Server
上面。
在配置文件 application.yml
加入 服务注册地址:
eureka:
client:
service-url:
defaultZone: http://locahost:8761/eureka/
在配置文件 application.yml
加入相关配置,从 service-id
为 config-server
的 配置服务 读取相关 配置文件。
spring:
application:
name: config-client
cloud:
config:
fail-fast: true
discovery:
enabled: true
service-id: config-server
profiles:
active: dev
server:
port: 8762
eureka:
client:
service-url:
defaultZone: http://localhost:8761/eureka/
重新启动应用程序 config-server
和 config-client
,再次访问 http://localhost:8762/foo
,服务端的响应数据如下:
foo version 2
只需要启动多个 config-server
实例,即可搭建一个 高可用 的 config-server
集群。
5. 使用Spring Cloud Bus刷新配置
Spring Cloud Bus
将 分布式节点 通过轻量级的 消息代理 连接起来。它可以用于 广播配置文件 的更改或者 服务之间 的通讯,也可以用于 监控。在 分布式配置文件 被更改后,可以通过 Spring Cloud Bus
通知各个微服务中的即时刷新 本地配置。
5.1. 改造config-client
在 config-client
的 pom.xml
里面加入 起步依赖 spring-cloud-starter-bus-amqp
。
org.springframework.cloud
spring-cloud-starter-bus-amqp
在项目的配置文件 application.yml
文件中添加 RabbitMQ
的相关配置,包括 RabbitMQ
的 地址、端口、用户名 和 密码。为了方便验证,将 management.security.enabled
改为 false
。
spring.rabbitmq.host=localhost
spring.rabbitmq.port=5672
spring.rabbitmq.username=guest
spring.rabbitmq.password=guest
management.security.enabled=false
最后,在需要更新属性的 配置类 上加 @RefreshScope
注解。
@RefreshScope
@RestController
@SpringBootApplication
public class ConfigClientApplication {
public static void main(String[] args) {
SpringApplication.run(ConfigClientApplication.class, args);
}
@Value("${foo}")
private String foo;
@RequestMapping(value = "/foo")
public String foo(){
return foo;
}
}
依次启动应用,启动两个 config-client
实例,端口 分别为 8762
和 8763
。启动完成后,访问 http://localhost:8762/foo
或者 http://localhost:8763/foo
,服务端响应数据如下:
foo version 2
更改远程Git
仓库 配置文件 的 config-client-dev.properties
,将 foo
的值改为 “foo version 3”
。
访问 http://localhost:8762/bus/refresh
请求 刷新配置,设置 “destination”
参数为 待刷新 属性的 服务名称。例如 “http://localhost:8762/bus/refresh?destination=config-client:**”
,即 刷新服务名 为 config-client
的所有 服务实例。
再次访问 http://localhost:8762/foo
和 http://localhost:8763/foo
,服务端响应数据如下:
foo version 3
测试结果表明,/bus/refresh
通知服务名为 config-client
的所有实例 刷新 了本地的 foo
属性配置。
参考
- 方志朋《深入理解Spring Cloud与微服务构建》
欢迎关注技术公众号: 零壹技术栈
本帐号将持续分享后端技术干货,包括虚拟机基础,多线程编程,高性能框架,异步、缓存和消息中间件,分布式和微服务,架构学习和进阶等学习资料和文章。