SpringCloud之Config
1.背景
在前的学习中,我们几乎解决了springCloud的所有常规应用,但是大家有没有想过这样一个问题:
是使用微服务后,有非常多的application.yml文件,每个模块都有一个,实际开发中还有开发环境、测试环境、预发布环境、正式环境等,
可能经常修改配置文件,但是不能每次都到项目中去修改呀,这样得把人累死,于是springCloud config就挺身而出,解决了这个问题。
2.springCloud config简介
Spring Cloud Config为分布式系统中的外部配置提供服务器和客户端支持。
使用Config Server,您可以在所有环境中管理应用程序的外部属性。
客户端和服务器上的概念映射与Spring Environment和PropertySource抽象相同,因此它们与Spring应用程序非常契合,但可以与任何以任何语言运行的应用程序一起使用。
随着应用程序通过从开发人员到测试和生产的部署流程,您可以管理这些环境之间的配置,并确定应用程序具有迁移时需要运行的一切。
服务器存储后端的默认实现使用git,因此它轻松支持标签版本的配置环境,以及可以访问用于管理内容的各种工具。
可以轻松添加替代实现,并使用Spring配置将其插入。
来自:https://www.springcloud.cc/spring-cloud-config.html
总结:就是将配置文件与代码分离,单独放在一个git库里面独立管理
实现原理图:
3.config server端简单使用
第一步:创建一个专门放配置文件的git仓库,如果还不会使用git仓库,可以学习<<git实战>>
创建好的git仓库地址为:https://github.com/bangbangw/demo-config.git
随便上传一个application.yml文件到该仓库,为了便于理解,我这里直接拷贝之前项目里面的application.yml文件,然后按照对应的端口号命名,
例如上传9001的application.yml文件命名为:application-9001.yml
实际上传后的git仓库文件如下:
第二步:创建config服务端模块:config-server-5001
pom.xml文件 依赖
<dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-config-server</artifactId> </dependency> <!-- 避免Config的Git插件报错:https://mvnrepository.com/artifact/org.eclipse.jgit/org.eclipse.jgit --> <dependency> <groupId>org.eclipse.jgit</groupId> <artifactId>org.eclipse.jgit</artifactId> <version>4.10.0.201712302008-r</version> </dependency>
application.yml文件
# 基本配置
server:
port: 5001
context-path: /
# 应用名称、git地址配置
spring:
application:
name: service-config
cloud:
config:
server:
git:
skipSslValidation: true #是否跳过https检查
uri: https://github.com/bangbangw/demo-config.git #git仓库地址,也可以不添加.git后缀
search-paths:
- path1 # 注意 - 与 path1 之间有空格,非根路径下得目录
- path2
#username: xxxx git 登录名 (一般都是配置的秘钥登录,不是账号密码登录)
#password: xxxx git 登录密码
ConfigServerApplication_5001.java 启动文件
package com.wfd360; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; import org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration; import org.springframework.cloud.config.server.EnableConfigServer; /** * @author 姿势帝-博客园 * @address https://www.cnblogs.com/newAndHui/ * @WeChat 851298348 * @create 07/25 4:57 * @description */ @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class, HibernateJpaAutoConfiguration.class}) @EnableConfigServer public class ConfigServerApplication_5001 { public static void main(String[] args) { SpringApplication.run(ConfigServerApplication_5001.class, args); } }
第三步:测试
启动5001
请求路径匹配规则:
/{application}/{profile}[/{label}]
/{application}-{profile}.yml
/{label}/{application}-{profile}.yml
/{application}-{profile}.properties
/{label}/{application}-{profile}.properties
我们使用简单的第二条即:/{application}-{profile}.yml
实际访问路径:http://localhost:5001/application-9001-profile.yml ,结果如下:
4.config client基本使用
客户端其实就是指将之前我们的模块不读取本地文件,而是将配置文件放在git,然后使用git上的配置文件,
如果是实际生产很简单:1.上传配置文件到git; 2.填加一个 bootstrap.yml文件, 搞定!
案例中,我们以改造6001为例讲解
第一步:在6001中添加 bootstrap.yml,用于连接config server服务端
为了优先读取config server 中的配置文件,我们需要把读取config server相关的配置放入 bootstrap.yml,把其他配置放入 application.yml中
因此:
bootstrap.yml 文件为:
spring:
application:
name: config-client-dev
cloud:
config:
uri: http://localhost:5001 # config server 服务端地址
label: master # git中的分支 默认master
name: application6001 # 文件名称
profile: dev2 # 文件名, 最终生效文件名称是git上的:name + dev = application6001-dev.yml
fail-fast: true
为了便于区分到底读取的是git上的配置文件还是本地的 application.yml 文件,我们在application.yml 文件中添加一个参数
# 自定义配置参数,假设是实际生产中的微信openid
sys:
weChat:
appid: 1111111111111-default
为了便于测试,写一个测试用的controller为:TestController ,只是为了测试
package com.wfd360.controller; import org.springframework.beans.factory.annotation.Value; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; /** * @author 姿势帝-博客园 * @address https://www.cnblogs.com/newAndHui/ * @WeChat 851298348 * @create 07/25 6:42 * @description */ @RestController public class TestController { @Value(value = "${sys.weChat.appid}") private String appId; /** * 模拟测试:config client 是否生效 * 测试逻辑:如果生效,获取到的appid将不一样 */ @GetMapping("/api/appid") public Object getAppId() { System.out.println("appid=" + appId); return appId; } }
第二步:上传测试用的application.yml文件,这里以上传6001模块的application为例
application6001-dev.yml配置文件
server:
port: 6001
context-path: /
# 数据源配置
spring:
application:
name: service-ticket
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/db_station
username: root
password: admin
jpa:
hibernate:
ddl-auto: update
show-sql: true
thymeleaf:
cache: false
# eureka 注册中心配置
eureka:
instance:
hostname: localhost #eureka客户端主机实例名称
appname: service-ticket #客户端服务名称(可以随意取)
instance-id: service-ticket:6001 #客户端实例名称(可以随意取)
prefer-ip-address: true #显示ip地址
client:
service-url:
#defaultZone: http://localhost:7001/eureka #eureka的服务器地址(单机)
defaultZone: http://eureka7001.wfd360.com:7001/eureka/,http://eureka7002.wfd360.com:7002/eureka/,http://eureka7003.wfd360.com:7003/eureka/ # 集群
# 服务提供者信息
info:
version: v2
WeChat: 851298348
负责人: 姿势帝
# 自定义配置参数
sys:
weChat:
appid: 1111111111111-dev
为了便于验证测试结果,我在文件末尾添加了不同的微信openid,若果是dev文件为.....11-dev,如果是prd文件为.....11-prd,如果是test文件为.....11-test
第三步:测试
启动config server 服务5001,在启动config client 客户端 6001,
测试服务端是否能正常访问:http://localhost:5001/application6001-dev-profile.yml
测试服务端是否能正常访问:http://localhost:5001/application6001-prd-profile.yml
测试服务端是否能正常访问:http://localhost:5001/application6001-test-profile.yml
通过如下修改
然后访问:http://localhost:6001/api/appid 观察结果.
到此,我们已经完成了如何将application.yml文件存放在git,然后项目获取并生效,达到了常规微服务项目对配置文件的管理需求.
当然,大家在测试的过程分钟发现,虽然配置文件确实生效了,但是每次修改都需要重启项目,感觉还是有点不完美,
其实要完成这个,也是很简单的,只是需要涉及到消息队列,但是我们还没有详细讲解消息队列相关的知识......因此感兴趣的同学可以先自己查资料完成这个,获取期待我们下次的课程补充上这个.
完美!
springCloud课程与代码下载:https://www.cnblogs.com/newAndHui/p/13210228.html