初始化“数据库”
解压源码,按照maven格式将源码导入IDE, 使用maven进行编译即可,源码结构如下图所示:
- xxl-conf-core:公共依赖
- xxl-conf-samples: 接入XXl-CONF的示例项目,供用户参考学习
- xxl-conf-sample-frameless: 无框架版本,main方法直接启动运行
- xxl-conf-sample-spring: spring版本
- xxl-conf-sample-springboot: springboot版本
- xxl-conf-sample-jfinal: jfinal版本
- xxl-conf-sample-nutz: nutz版本
项目:xxl-conf-admin
方式1:源码编译方式搭建:
- 配置文件位置:
/xxl-conf/xxl-conf-admin/src/main/resources/application.properties
- 配置项说明:
- 配置中心启动:
项目编译打包后,可直接通过命令行启动;
// 方式1:使用默认配置,mysql默认为本地地址;
java -jar xxl-conf-admin.jar
// 方式2:支持自定义 mysql 地址;
java -jar xxl-conf-admin.jar --spring.datasource.url=jdbc:mysql://127.0.0.1:3306/xxl-conf?Unicode=true&characterEncoding=UTF-8
方式2:Docker 镜像方式搭建:
- 下载镜像
// Docker地址:https://hub.docker.com/r/xuxueli/xxl-conf-admin/
docker pull xuxueli/xxl-conf-admin
- 创建容器并运行
/**
* 如需自定义 mysql 等配置,可通过 "PARAMS" 指定;
* 配置项参考文件:/xxl-conf/xxl-conf-admin/src/main/resources/application.properties
*/
docker run -e PARAMS="--spring.datasource.url=jdbc:mysql://127.0.0.1:3306/xxl-conf?Unicode=true&characterEncoding=UTF-8 " -p 8080:8080 -v /tmp:/data/applogs --name xxl-conf-admin -d xuxueli/xxl-conf-admin
"配置中心" 集群:
配置中心支持集群部署,提高配置中心负载能力和可用性。配置中心集群部署时,项目配置文件保持一致即可。
A、引入maven依赖
<!-- xxl-conf-client -->
<dependency>
<groupId>com.xuxueli</groupId>
<artifactId>xxl-conf-core</artifactId>
</dependency>
B、添加“XXL-CONF 配置信息”
/xxl-conf/xxl-conf-samples/xxl-conf-sample-springboot/src/main/resources/application.properties
配置项说明
# 配置中心跟地址,必填;
xxl.conf.admin.address=http://localhost:8080/xxl-conf-admin
# 环境配置,必填;如"test、ppe、product"等,指定配置加载环境;
# 配置中心接入验证TOKEN,选填,非空时启用,进行安全严重
xxl.conf.access.token=
# 配置快照文件地址,必填;会周期性缓存到本地快照文件中,当从配置中心获取配置失败时,将会使用使用本地快照文件中的配置数据;提高系统可用性;
xxl.conf.mirrorfile=/data/applogs/xxl-conf/xxl-conf-mirror-sample.properties
C、设置“XXL-CONF 配置工厂”
可参考配置文件:
@Bean
public XxlConfFactory xxlConfFactory() {
XxlConfFactory xxlConf = new XxlConfFactory();
xxlConf.setAdminAddress(adminAddress);
xxlConf.setEnv(env);
xxlConf.setAccessToken(accessToken);
xxlConf.setMirrorfile(mirrorfile);
logger.info(">>>>>>>>>>> xxl-conf config init.");
return xxlConf;
至此,配置完成。
a、添加和更新配置
参考章节 "4.2 配置管理" 添加或更新配置信息;