为什么需要配置中心?
- 对 应用的配置进行统一管理;
- 不同环境实现不同的配置;
- 运行时动态修改(我们项目使用的是 apollo)
springCloud config 简介
Config是SpringCloud的统一配置中心,包括 Config Server 和 Config Client 两部分,Config Server 使用Git存储配置内容,Config Server 操作存储在 Config Server 中的配置。所有微服务都指向 Config Server,启动时请求 Config Server 获取需要的配置属性,缓存以提高性能。
服务端
springCloud 作为 config server 管理公司项目的配置文件。
有一个 git 仓库,里面全部是项目不同环境的配置文件,configServer 依赖 zk ,会配置上述 git 仓库地址。
configServer 启动后作为服务提供者把服务注册到 zk。 通过@EnableConfigServer注解将自己注册到zk.
zk 会创建 services /服务名称 文件目录。 zk 中注册的数据格式:
里面有 configServer 所服务器的 ip 端口。
{
"name":"ifcoin-config-server-zk",
"id":"f1d6b933-88b1-4063-bb9a-2ef24d486762",
"address":"47.99.177.133",
"port":9911,
"sslPort":null,
"payload":{
"@class":"org.springframework.cloud.zookeeper.discovery.ZookeeperInstance",
"id":"application-1",
"name":"ifcoin-config-server-zk",
"metadata":{
}
},
"registrationTimeUTC":1576582070231,
"serviceType":"DYNAMIC",
"uriSpec":{
"parts":[
{
"value":"scheme",
"variable":true
},
{
"value":"://",
"variable":false
},
{
"value":"address",
"variable":true
},
{
"value":":",
"variable":false
},
{
"value":"port",
"variable":true
}
]
}
}
客户端
每个项目都有一个 bootstrap.yml 配置文件,应用启动时,会通过yml,拉取项目配置文件;
profile:代表环境;
label: 代表git 代码分支;
service-id:和 configServer 配置的service-id 保持一致;
spring:
application:
name: ifcoin-websocket-app
cloud:
zookeeper:
conne ct-string: ${ZOOKEEPER_SERVER:127.0.0.1:2181}
config:
profile: ${SPRING_PROFILE:daily}
label: master
discovery:
enabled: true
service-id: ifcoin-config-server-zk
management:
endpoints:
web:
exposure:
include: "*"
server:
servlet:
context-path: /monitor
客户端 通过 @EnableDiscoveryClient 注解,并配置相同的 service-id,可以在 zk 中找到configServer 所在服务器的 ip,端口。进而可以通过 rest +profile +label 拿到对应应用,对应环境、分支的配置文件。
原理
configServer 会提供 rest 接口出来,应用通过 zk 找到 configServer 的 ip,端口,发送 rest 请求,获取配置。
原理图:
源码
EnvironmentController 提供了 rest 接口,
底层核心逻辑使用 jgit客户端 操作 git 拉取对应分支, see JGitEnvironmentRepository.refresh();
public String refresh(String label) {
Git git = null;
try {
git = createGitClient();
if (shouldPull(git)) {
FetchResult fetchStatus = fetch(git, label);
if (deleteUntrackedBranches && fetchStatus != null) {
deleteUntrackedLocalBranches(fetchStatus.getTrackingRefUpdates(), git);
}
// checkout after fetch so we can get any new branches, tags, ect.
checkout(git, label);
if (isBranch(git, label)) {
// merge results from fetch
merge(git, label);
if (!isClean(git, label)) {
logger.warn("The local repository is dirty or ahead of origin.
Resetting"+ " it to origin/" + label + ".");
resetHard(git, label, LOCAL_BRANCH_REF_PREFIX + label);
}
}
}
else {
// nothing to update so just checkout
checkout(git, label);
}
// always return what is currently HEAD as the version
return git.getRepository().findRef("HEAD").getObjectId().getName();
}
catch (RefNotFoundException e) {
throw new NoSuchLabelException("No such label: " + label, e);
}
catch (NoRemoteRepositoryException e) {
throw new NoSuchRepositoryException("No such repository: " + getUri(), e);
}
catch (GitAPIException e) {
throw new NoSuchRepositoryException(
"Cannot clone or checkout repository: " + getUri(), e);
}
catch (Exception e) {
throw new IllegalStateException("Cannot load environment", e);
}
finally {
try {
if (git != null) {
git.close();
}
}
catch (Exception e) {
this.logger.warn("Could not close git repository", e);
}
}
}
shouldPull() 方法 会调用 git status 判断是否需要从仓库获取,否则直接checkout 目标分支。
protected boolean shouldPull(Git git) throws GitAPIException {
boolean shouldPull;
if (this.refreshRate > 0 && System.currentTimeMillis() -
this.lastRefresh < (this.refreshRate * 1000)) {
return false;
}
Status gitStatus = git.status().call();
boolean isWorkingTreeClean = gitStatus.isClean();
String originUrl = git.getRepository().getConfig()
.getString("remote", "origin", "url");
if (this.forcePull && !isWorkingTreeClean) {
shouldPull = true;
logDirty(gitStatus);
}
else {
shouldPull = isWorkingTreeClean && originUrl != null;
}
if (!isWorkingTreeClean && !this.forcePull) {
this.logger.info("Cannot pull from remote " + originUrl
+ ", the working tree is not clean.");
}
return shouldPull;
}
操作 git 依赖的 jgit 客户端;
<dependency>
<groupId>org.eclipse.jgit</groupId>
<artifactId>org.eclipse.jgit</artifactId>
</dependency>