# 介绍

# 为什么要造轮子？

之前试用过几个开源的配置中心(disconf、Apollo、diamond以及Spring Cloud Config)，各有弊端或者是不满足我们的需求(譬如部署复杂、功能太复杂、不支持全局配置、不支持敏感配置加密，对springboot支持不友好,界面不友好或者无界面等等)。所以从2016年开始有了一个初级版本，经过三年生产环境实际需求不断完善于是就有了这个开源项目。

# 主要功能清单

支持多环境、多版本配置管理
支持全局配置
支持配置文件(properties,yaml,xml)、配置项、json配置支持
支持加密配置(server自动加密，client自动解密)
支持spring、springboot无缝对接
支持环境+项目维度精细化权限(只读/读写)控制
支持http和zookeeper方式配置实时同步
支持查看配置历史版本、一键回滚、版本对比
安全功能支持:可选开启安全ip功能与内网拉取配置限制
多业务组/部门数据隔离
支持集群部署

# 特点

轻量级：无需任何中间件(http方式下发同步)即可运行
代码简单：二开成本低
安全性高：除了配置加密功能外，还提供多种拉取配置安全策略

# 服务端部署

# 下载项目

git clone https://gitee.com/vakinge/mendmix-config.git

# 编译项目

mvn clean package -DskipTests=true

最终生成部署包为：mendmix-config-server/target/mendmix-config-server.jar

# 创建数据库表

CREATE DATABASE IF NOT EXISTS `configcenter` DEFAULT CHARSET utf8 COLLATE utf8_general_ci;

执行sql目录下数据库脚本: init.sql 与 testdata.sql (此为测试数据，可选)

# 关键配置说明（启动前请自行修改各个环境的配置）

#数据库配置
db_host=127.0.0.1
#数据名
db_name=configcenter
db_username=root
db_password=123456

#是否允许外网拉取配置（白名单机制生效）
api.extranet.enabled=true
#敏感配置是否强制加密
sensitive.config.force.encrypt=false

#开启自动缓存（依赖redis）
mendmix.mybatis.cacheEnabled=true
mendmix.cache.mode=standalone
mendmix.cache.servers=127.0.0.1:6379
mendmix.cache.password=123456
mendmix.cache.database=0

#开启共享session（集群部署必须）
security.cache.storage-type=redis
security.cache.servers=127.0.0.1:6379
security.cache.password=123456
security.cache.database=1

# 启动

拷贝mendmix-config-server.jar 与 application.properties 在同一目录，springboot会优先加载同一目录下名为_application.properties的配置文件。

启动命令

java -jar mendmix-config-server.jar
# 或 （适合linux或mac 后台运行）
nohup java -jar mendmix-config-server.jar > config-server.out 2>&1 &

本地访问：http://127.0.0.1:8180 ,账号密码：admin/admin123

# 操作指引

业务组管理：如果需要分多个业务组，各个组需要隔离，请先添加业务组;
用户管理：添加用户，可以指定业务组，默认密码为手机号后八位；
profile(环境)管理：可以为每个环境配置配置同步的zookeeper以及拉取配置IP白名单
应用管理：添加应用,会自动生成对应每个环境的token
配置管理：配置分全局配置与应用配置，支持配置文件、key-value配置、json配置

# 应用集成（客户端）

# 添加依赖

<dependency>
  <groupId>com.mendmix</groupId>
  <artifactId>mendmix-config-client</artifactId>
 <version>[版本号]</version>
</dependency>

查看版本号请进入客户端maven 仓库 (opens new window)查看

# 添加配置

在项目增加如下配置：

#是否启用配置中心，默认：true
mendmix.configcenter.enabled=false
#应用名：对应server端的应用配置
mendmix.configcenter.appName=account
mendmix.configcenter.baseUrl=http://configserver:8080
#当前环境
mendmix.configcenter.profile=dev
#拉取配置版本，默认:latest
mendmix.configcenter.version=latest
#是否忽略全局配置,默认：false
mendmix.configcenter.global-ignore=false
#拉取配置认证的token
mendmix.configcenter.token=
#同步方式，默认:http
mendmix.configcenter.sync-type=zookeeper
# 同步间隔，同步方式为：http时生效
mendmix.configcenter.sync-interval-seconds=30

通过JVM参数外部设置配置方式

-Dmendmix.configcenter.profile=dev

docker外部设置配置方式

-e mendmix.configcenter.profile="dev"

springboot项目增加以上配置即可，spring项目还需要做如下修改：

去掉原加载配置相关配置
新增配置

<bean class="com.mendmix.confcenter.spring.CCPropertyPlaceholderConfigurer">
    <property name="remoteEnabled" value="true" />
    <!-- 本地配置文件，无本地配置可不配置 -->
    <property name="locations">
      <list>
        <value>classpath*:application.properties</value>
      </list>
    </property>
</bean>

# 一些用法

# 配置优先级

应用本地配置 > 远程应用配置 > 远程全局配置
配置中心配置mendmix.configcenter.remote-config-first=true可以启用远程配置覆盖本地配置

# 配置实时生效

配置变更后会实时下发到应用，可以通过以下方式实时读取最新配置

在代码中使用ResourceUtils实时读取
依赖注入Environment，在代码中实时读取
实现ConfigChangeHanlder接口，自定义刷新逻辑

@Controller  
@RequestMapping(value = "/sms")
public class AuthCommonController implements ConfigChangeHanlder{

    @Value("${sms.send.open}")
    private boolean open = false;


    @Override
    public void onConfigChanged(Map<String, Object> changedConfigs) {
        if(changedConfigs.containsKey("sms.send.open")){
            open = Boolean.parseBoolean(changedConfigs.get("sms.send.open").toString());
        }
    }
}

# 配置忽略

正常情况应用的配置为全局配置与应用自身配置合并的结果，如果不需要某些全局配置项目如下配置即可

db.maxActive=[Ignore]