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中查阅
欢迎大家的意见跟建议
代码仓库 (博客配套代码)
想获得最快更新,请关注公众号
