Skip to content

chengjk/conflab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Conflab

tags: conflab


当前版本v1.0.3,详细见RELEASE.md

Conflab,一个集群式配置中心,实现了业务系统配置项的统一管理。配置项存于zookeeper,更新时消息通知对应客户端。客户端需要设置ZK地址,我们把它写入环境变量即可做到零配置。

服务端conflab-sever管理配置项并推送更新zookeeper;客户端conflab-client端监听zookeeper并更新配置项,业务系统从客户端缓存中获取最新配置项;演示模块conflab-demo是业务系统使用client的一个示例。

Getting started

  • 配置zookeeper环境变量
ZK_ADDRESS=127.0.0.1:2181
  • 编译工程
mvn clean package -DskipTests=true

server端编译完是一个可以解压运行的zip,解压后运行./bin/start.sh启动。目录:

.
├── application.properties
├── bin
│   ├── start.cmd
│   └── start.sh
├── conflab-server-1.0-SNAPSHOT.jar
├── conflab-server-1.0-SNAPSHOT-sources.jar
├── lib
└── static
    ├── css
    ├── index.html
    ├── js
    ├── lib
    ├── package.json
    └── temp

通过界面增加配置并推送。

测试用url:/t/save

结构

服务端数据存在zookeeper。数据更新时客户端收到zookeeper通知,更新各自本地缓存。

系统结构图

服务端 conflab-server

启动

bin目录下有start.sh供linux下启动,start.cmd则在windows下启动。启动之后访问http://localhost:8080/index.html就进入了服务端的管理页面。

主页后增加url参数key?key=my等同于在主页搜索框中搜索关键字‘my’。

这类连接可以作为常用收藏到浏览器,访问就可以实现关键字检索,再也不用被不相关的内容干扰了。e.g.团队中没人都有自己的配置,以自己名字作为关键字就是很好的选择。

配置

因为配置数据都在zookeeper上,需要在服务端主机上配置zookeeper的环境变量,每个客户端也需要配置相同的环境变量。 系统常用的配置项在根目录application.properties文件中。这里可以修改端口,数据库类型和数据库连接信息。

注意:使用默认数据库SQLite,当spring.jpa.hibernate.ddl-auto=update 时启动会报错,因此默认配置是create,也就是每次启动都会重新创建新表。建议首次启动表生成之后把这个配置注释掉。这个问题后续版本修改。

工程介绍

Server端负责更新维护zookeeper,可以通过浏览器快捷的管理更新配置,不直接与client端通信。(也就是说,只要数据结构正确,任何一个zookeeper管理工具都可以代替Server端,例如zooInspector。)

工程前后端分离,前端是最常见的html+js静态页面,毕竟是小工具,越简单越好。后端使用spring boot,spring mvc,maven打包。

系统实现了对配置内容分应用分组管理。支持多系统,系统内按业务分组。以应用为单位更新到zookeeper,与该应用相关的客户端会都收到更新消息。

客户端 conflab-client

client端是jar,添加到项目依赖即可。v1.0.3版本增加了golang 客户端,conflab-client-go,引入即可使用。

配置好ZK地址后,业务系统可以很容易得到想要配置项:

String value=Conflab.getString("key");

客户端监听Zookeeper的更新事件,默认实现了更新本地配置缓存。其他业务需要可以在回调函数里实现。

客户端对app(对应zookeeper目录)的监听有两种模式:开发模式和生产模式。

  • 生产模式比较简单,监听对象固定不变,使用常量即可,例如server

  • 团队开发模式中,源码都是一样的,每个人却需要各自的配置,配置不能加入版本管理。需要在主机的CONFLAB_HOME目录或用户目录下conflab.properties文件中配置一个或多个对应,如:

    server=jacky-server
    demo=jacky-demo
    

    这样开发环境下server使用jacky-server配置,demo同理。

支持公共配置。公共配置变化时,会更新所有子系统的客户端。

客户端只是一个jar包,引入到业务系统中即可。使用办法可以参考范例conflab-demo。client也是特别轻,只依赖了logback和zk客户端。简单。

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published