springboot 轻量级配置中心

6 篇文章 0 订阅

工程简介

springboot 轻量级配置中心
项目地址:https://gitee.com/hongmin_shm/lightweight-config-spring-boot-starter

配置中心现有的实现方式有很多,例如SpringCloud生态微服务组件SpringCloud Config、Alibaba开源Nacos框架、携程开源框架Apollo、百度开源配置中心Disconf 等,但对于中小型项目来说,上述方案要么需要整个项目采用spring cloud微服务架构,要么需要考虑配置中心的服务稳定问题(集群部署费时费力),并且有一定的代码侵入不方便未来切换

基于这样的现状,期望配置中心能够在满足基本需求的同时尽量保持"轻量",lightweight-config配置中心带来如下特性:

  1. 考虑到配置中心的稳定性,采用git私有仓库或者DB来存储无论在成本方面以及稳定性(RDS)、安全性方面都有极大的优势
  2. 代码无侵入或者只需要极少的适配代码,继续使用spring @Value注入配置值,同时又不必大量改写现有的项目代码
  3. 动态配置,无须重启项目自动热更新

可以发现,lightweight-config 就是在不使用SpringCloud的前提下,拥有SpringCloud Config的优良特性 🐶

实现原理

基于springboot配置拓展EnvironmentPostProcessor实现容器初始化之前加载远程配置注入到上下文,同时结合一系列Aware回调以及反射实现配置热更新

配置刷新采用定时任务拉取的方式,尚未实现配置更新自动感知功能,可以根据实际需要在配置中指定定时任务的开启和关闭

本项目涉及springboot拓展以及Bean的生命周期等源码知识,用来巩固知识储备也是不错的选择

使用方式

  1. 当前项目并没有发布到中央仓库,所以需要下载本项目到本地,执行mvn -U clean install -DskipTest将jar包安装到本地仓库
  2. 引入starter依赖
<dependency>
    <groupId>com.youcheng.configcenter</groupId>
    <artifactId>lightweight-config-spring-boot-starter</artifactId>
    <version>1.0.0-SNAPSHOT</version>
</dependency>
  1. 根据实际采用的存储方式,配置git token或者数据库链接信息,采用DB (Mysql)时,需要先执行 mysql-schema.sql 建表
# mysql 存储(mysql、gitee二选一)
lightweight:
  config:
    provider: com.youcheng.configcenter.provider.DataBaseConfigProvider
    data-base:
      driver-class-name: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql://localhost:3306/config_center
      username: root
      password: mysql123
    configfile:
      id: abcdefg
      profile: local

# gitee 存储(mysql、gitee二选一)
lightweight:
  config:
    provider: com.youcheng.configcenter.provider.GiteeConfigProvider
    gitee:
      url: https://gitee.com/api/v5/repos/hongmin_shm/springboot-config-center/contents/application.properties
      token: 5d6d60f188c3bf790c180dbfb56ff305

# 开启定时任务刷新
     refresh:
       enable: true # 是否开启配置刷新,默认false
       delay: 5 # 刷新间隔,单位秒

gitee 配置方法

  1. 官网注册gitee账号(如果有账号可以跳过)

  2. 建一个专门存储配置文件的git仓库(配置信息敏感请设置仓库为私有),新建一个application.properties 配置文件并push

  3. 点击头像->设置
    在这里插入图片描述
    安全设置-> 私人令牌,生成令牌(即access_token)
    在这里插入图片描述

  4. 参考gitee openapi 获取仓库具体路径下的内容 配置一个访问application.properties的http链接,可以点击页面下方的测试按钮查看是否配置成功

例如:https://gitee.com/api/v5/repos/hongmin_shm/springboot-config-center/contents/application.properties
在这里插入图片描述

  1. 将4中生成的链接以及3中生成access_token 配置到引入配置中心的工程中,启动项目即可进行测试
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-bp7bulNK-1666667565619)(static/20221024230039.jpg)]

配置文件表结构设计

CREATE TABLE `application_config_center_info` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
  `file_id` varchar(64) NOT NULL COMMENT '文件ID',
  `name` varchar(64) NOT NULL COMMENT '文件名',
  `profile` varchar(64) NOT NULL COMMENT '环境',
  `extension` varchar(16) NOT NULL COMMENT '后缀(properties、yaml、json等)',
  `content` text NOT NULL COMMENT '配置内容',
  `last_updated_time` datetime(6) NOT NULL COMMENT '最后更新时间',
  `last_updated_user` varchar(32) DEFAULT 'system' COMMENT '最后更新操作人',
  `version` int NOT NULL COMMENT '版本',
  PRIMARY KEY (`id`),
  KEY `idx` (`file_id`,`profile`,`version`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci ROW_FORMAT=DYNAMIC COMMENT='应用配置中心信息表';

关于定时任务

由于目前配置更新是采用定时任务拉取,所以时间间隔是一个需要在效率和实时方面进行权衡,为了尽量减少系统资源的浪费,对于DB存储的方式,定时任务会先比对version是否有变更以及对比lastUpdatedTime时间戳,尽量在有必要的情况再进行配置的热更新
如有更好的实现方式,例如怎样对配置进行监听,主动推送配置更新事件来通知使用方进行实时更新,欢迎提pr

拓展

  1. 自定义远程配置加载方式
    当前支持git以及DB存储配置,也可以拓展为其他存储方式例如本地文件,参考com.youcheng.configcenter.provider.RemoteConfigProvider
  2. 自定义文件格式解析
    当前支持properties、json、yaml(尚不完善)格式的文本格式解析,可以拓展其他格式,参考com.youcheng.configcenter.convertor.ResourceConvertor

欢迎pr、issu、讨论
个人联系方式:(wechat)15043284139 (email)hongmin.shm@aliyun.com
项目地址:https://gitee.com/hongmin_shm/lightweight-config-spring-boot-starter

评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

hongmin.shm

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值