Spring Cloud Bus 将分布式的节点用轻量的消息代理连接起来。它可以用于广播配置文件的更改或者服务之间的通讯,也可以用于监控。本文要讲述的是用Spring Cloud Bus实现通知微服务架构的配置文件的更改。
一、准备工作
本文还是基于上一篇文章来实现。按照官方文档,我们只需要在配置文件中配置 spring-cloud-starter-bus-amqp ;这就是说我们需要装rabbitMq,至于怎么安装和使用 rabbitmq,搜索引擎下,或是参考 RabbitMq安装教程。
二、改造 client 服务
1、引用之前篇章所创建的实例:leopard-eureka,leopard-config,leopard-service。
2、在leopard-service 和 leopard-config 的 pom文件加上起步依赖 spring-cloud-starter-bus-amqp,配置文件如下:
<!-- bus -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-bus-amqp</artifactId>
</dependency>
<!-- 监控 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
spring-boot-starter-actuator(健康监控)配置和使用
3、在 leopard-service 的配置文件 bootstrap.properties
还有 leopard-config 的配置文件 application.properties
中加上RabbitMq的配置,包括地址、端口,用户名、密码,代码如下:
#rabbit
spring.rabbitmq.host=localhost
spring.rabbitmq.port=5672
spring.rabbitmq.username=用户名
spring.rabbitmq.password=密码
4、在引用配置的类上添加动态注解 @RefreshScope ,注意事项可参考spring cloud:config-server中@RefreshScope的"陷阱"
5、依次启动 leopard-eureka 、leopard-confg、leopard-service(分别启动端口 8081 和 8082 两个客户端)。
(小插曲)如果启动 leopard-service 报如下错误可依情况处理:
情况a:
此情况检查连接的配置IP、端口、用户名、密码是否正确。
情况b:
此情况为自己配置连接的用户名密码是否有权限,配置方式可参看 RabbitMq安装教程。
6、都正常启动后,我们先访问: http://localhost:8081/test/getName, 查看浏览器显示
hi leopard,this name is :leopardName
7、这时我们去代码仓库将 config.name 的值改为“leopardName44”,即改变配置文件 config.name 的值。如果是传统的做法,需要重启服务,才能达到配置文件的更新。此时,我们只需要发送post请求:http://192.168.75.1:8081/bus/refresh,你会发现 leopard-service会重新读取配置文件,这里使用 shell 终端 post 访问,(简单的可以用 postman工具访问)
curl -d "" 192.168.75.1:8081/bus/refresh
随后看到返回
是因为开启了安全权限验证,导致链接失败。
接着我们查看 eclipse 的控制台输出:
他提示我们添加 “management.security.enabled” to false 关闭验证
那我们就在 leopard-service 的配置文件 bootstrap.properties 内添加
management.security.enabled=false
如果是 spring-boot 2.0 就要设置
management:
endpoints:
web:
exposure:
include: bus-refresh
重启服务 leopard-service,然后按照之前的步骤 6 和 7
再次请求刷新 leopard-service 控制台日志,可以看到请求成功,还有更新的参数
这时我们再访问 http://localhost:8082/test/getName 浏览器显示:
8081服务刷新,8082服务参数也变化,说明我们已经把整个引用服务配置参数都刷新了。
(注:如果不使用rabbitmq,也可以达到刷新效果,不过只能单台刷新,没法同步其他服务。)
另外,/bus/refresh接口可以指定服务,即使用"destination"参数,比如 “/bus/refresh?destination=customers:**” 即刷新服务名为customers的所有服务,不管ip。
三、分析
此时的架构图:
当文件更改的时候,通过pc端用post 向端口为8081的leopard-service 发送请求/bus/refresh/;此时8081端口会发送一个消息,由消息总线向其他服务传递,从而使整个微服务集群都达到更新配置文件。
四、其他扩展|(可忽视)
可以用作自定义的Message Broker,只需要spring-cloud-starter-bus-amqp, 然后再配置文件写上配置即可,同上。
Tracing Bus Events:
需要设置:spring.cloud.bus.trace.enabled=true,如果那样做的话,那么Spring Boot TraceRepository(如果存在)将显示每个服务实例发送的所有事件和所有的ack,比如:(来自官网)
{
"timestamp": "2015-11-26T10:24:44.411+0000",
"info": {
"signal": "spring.cloud.bus.ack",
"type": "RefreshRemoteApplicationEvent",
"id": "c4d374b7-58ea-4928-a312-31984def293b",
"origin": "stores:8081",
"destination": "*:**"
}
},
{
"timestamp": "2015-11-26T10:24:41.864+0000",
"info": {
"signal": "spring.cloud.bus.sent",
"type": "RefreshRemoteApplicationEvent",
"id": "c4d374b7-58ea-4928-a312-31984def293b",
"origin": "customers:9000",
"destination": "*:**"
}
},
{
"timestamp": "2015-11-26T10:24:41.862+0000",
"info": {
"signal": "spring.cloud.bus.ack",
"type": "RefreshRemoteApplicationEvent",
"id": "c4d374b7-58ea-4928-a312-31984def293b",
"origin": "customers:9000",
"destination": "*:**"
}
}