spring boot / cloud (十七) 快速搭建注册中心和配置中心
本文将使用spring cloud的eureka和config server来搭建.
然后搭建的模式,有很多种,本文主要聊的是将注册中心和配置中心整合成一个服务的方式.
对于其他方式,如果有同学感兴趣,还请自行百度,谢谢.
为什么将注册中心和配置中心整合在一起?
其实整合在一起和分开,在使用层面上并没有太大的区别,主要就是节省资源,启动一个服务就够了
开始搭建
添加pom依赖
<!-- eureka server --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-eureka-server</artifactId> </dependency> <!-- config server --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-config-server</artifactId> </dependency> <!-- amqp rabbitmq --> <dependency> <groupId>org.itkk.udf</groupId> <artifactId>udf-starter-amqp-rabbitmq</artifactId> </dependency>
以上为主要的依赖,引入了eureka server和config server以及amqp
amqp主要是为了支持config server的在runtime刷新各个子服务的配置文件的这个特性
pom关键配置
<resources> <resource> <directory>${project.basedir}/src/main/resources/</directory> <filtering>true</filtering> </resource> </resources>
以上配置可以使我们在待会的配置文件中引用maven的上下文属性,通过${xxx}的方式
<!-- package --> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <version>${springboot.version}</version> <executions> <execution> <goals> <goal>repackage</goal> </goals> </execution> </executions> </plugin>
添加打包插件,会将这个应用打包成一个可执行的jar包(内置容器,可直接启动应用)
编写启动类
@SpringCloudApplication @EnableEurekaServer @EnableConfigServer public class UdfEurekaConfigServerDemoApplication extends BaseApplication { /** * 描述 : spring boot的入口 * * @param args 参数 */ public static void main(String[] args) { SpringApplication.run(UdfEurekaConfigServerDemoApplication.class, args); } }
标记@SpringCloudApplication,@EnableEurekaServer,@EnableConfigServer开启注册中心和配置中心
同时这里继承了BaseApplication,这个类是前面博客中udf-starter-core中的一个类,此类做了一些简单的封装,详情大家可查阅
bootstrap.properties主要配置文件详解
info.build.group=${project.groupId} info.build.artifact=${project.artifactId} info.build.version=${project.version} info.build.name=${project.name} info.build.time=${project.build.date} info.build.encoding=${project.build.sourceEncoding} info.build.java.source=${java.version} info.build.java.target=${java.version}
以上配置,主要定义了应用的一些基础信息,并且这些基础信息都是通过${xxx}的方式直接从maven变量中获取的
这些信息在应用启动了之后,可以通过http://localhost:port/info访问
注意,这里的${project.build.date}是UTC时间,不是北京时间,所以查看的时候,要+8小时
spring.application.name=${project.name} server.port=${server.port} management.security.enabled=false spring.profiles.active=${profiles.activation}
以上配置主要设定了应用名称(使用项目的名称),应用端口(从pom中获取),以及profiles
bootstrap-xxx.properties主要配置文件详解
security.user.name=admin security.user.password=123456
设置应用的basic认证用户名和密码
eureka.instance.preferIpAddress=true eureka.client.enabled=true eureka.client.serviceUrl.defaultZone=http://admin:123456@127.0.0.1:${server.port}/eureka/ eureka.client.register-with-eureka=true eureka.client.fetch-registry=true
配置eureka实例和客户端信息,注意的是,因为这里是讲config server整合到注册中心上了,所以这里必须要将自身也注册到eureka上,否则,其他应用无法找到config server
spring.cloud.config.server.prefix=config-server spring.cloud.config.server.git.uri=https://git.oschina.net/wangkang/udf-sample.git spring.cloud.config.server.git.searchPaths=udf-config-hub/{application} spring.cloud.config.server.git.defaultLabel=master spring.cloud.config.server.git.forcePull=true
这里配置了config server的主要信息 ,
首先prefix是为了配置中心的上下文根和注册中心区分开来
然后在searchPaths中,spring cloud为我们预留了{application(应用名)}/{profile(环境)}/{label(分支)}这三个变量
大家可以根据这3个变量,灵活的组合远端git仓库中目录的结构,如下 :
usf-server-a -> usf-server-a-dev.properties -> usf-server-a-qa.properties usf-server-b -> usf-server-b-dev.properties -> usf-server-b-qa.properties
在这里的话,我只使用了{application}
spring.rabbitmq.host=itkk.org spring.rabbitmq.port=5672 spring.rabbitmq.username=dev_udf-sample spring.rabbitmq.password=1qazxsw2 spring.rabbitmq.virtual-host=/dev_udf-sample spring.rabbitmq.template.retry.enabled=true
以上配置了消息中间件rabbitmq的信息
.properties和.yml的区别 ?
本质上没有什么区别 , yml格式是属性结构的 , 可能对于某些同学来说 , 感觉更易于阅读 .
不过我不喜欢(哈哈) , 习惯用properties了 , 所以本文全部使用的是*.properties文件进行配置的 , 此格式的文件等价于*.yml , 如有偏好yml的同学 , 可自行转换
application.properties和bootstrap.properties的区别 ?
首先共同点 , 他们都可以用来配置参数 .
但是bootstrap的加载优先级高于application
在spring cloud应用中,官方也推荐使用bootstrap来存放配置
所以本文以及后续的配置项都会存放在bootstrap.properties中
如何区分profiles,来加载不同环境的配置文件 ?
在spring boot的中是通过spring.profiles.active属性来设置环境的,默认为dev
然后spring boot预先约定配置文件通过"-"分隔,"-"之后,".properties"之前,之间的部分就是profiles,例如 :
bootstrap.properties bootstrap-dev.properties bootstrap-qa.properties bootstrap-xxxx.properties
注意,没有带profiles的配置文件,称为默认配置,不管什么环境下,都是必然会被加载的.
然后在启动应用的时候,指定profiles即可,如下 :
java -server -jar demo-1.0.jar --spring.profiles.active=qa
如何动态刷新配置 ?
可在任何config client或者config service上执请求如下的HTTP服务 :
POST http://localhost:port/bus/refresh
那么,config server就会通过消息中间件rabbitmq将配置文件更新的事件通知到各个微服务中了.
结束
今天跟大家分享了整个注册中心和配置中心的样例和主要的配置,相关完整的项目大家可在udf-sample中的udf-eureka-config-server-demo中查阅
欢迎大家的意见跟建议
代码仓库 (博客配套代码)
想获得最快更新,请关注公众号