分布式配置管理平台 Disconf

Distributed Configuration Management Platform(分布式配置管理平台)

专注于各种分布式系统配置管理的通用组件/通用平台, 提供统一的配置管理服务。

包括百度、滴滴打车、银联、网易、拉勾网等知名互联网公司正在使用!

「disconf」在「2015 年度新增开源软件排名 TOP 100(OSC开源中国提供)」中排名第16强。

主要目标：

部署极其简单：同一个上线包，无须改动配置，即可在多个环境中(RD/QA/PRODUCTION) 上线
部署动态化：更改配置，无需重新打包或重启，即可实时生效
统一管理：提供web平台，统一管理多个环境(RD/QA/PRODUCTION)、多个产品的所有配置
支持微服务架构

demos

https://github.com/knightliao/disconf-demos-java

项目信息

CLIENT 端：
- Java: 目前唯一支持语言
- python：打算支持
- PHP：暂未支持
WEB 管理端：
- Java SpringMvc 实现，前后端分离实现方式(基于Spring 4.1.7.RELEASE)

java client

disconf.git branches and Maven version:

dev(develop branch): 2.6.31-SNAPSHOT
master(stable branch)：2.6.31
更新日志
在Maven Central Repository里查看 com.baidu.disconf

Java Client Elegant Usage Preview

注解式分布式配置使用方式
XML配置式分布式配置方式

当前版本功能特点

支持配置（配置项+配置文件）的分布式化管理
配置发布统一化
极简的使用方式（注解式编程或 XML无代码侵入模式）
低侵入性或无侵入性、强兼容性

未来版本（完全版）功能特点

Disconf的功能特点描述图：

查看大图

重要功能特点

支持配置（配置项+配置文件）的分布式化管理
配置发布统一化
- 配置发布、更新统一化:
  - 同一个上线包无须改动配置即可在多个环境中(RD/QA/PRODUCTION) 上线
  - 配置存储在云端系统，用户统一管理多个环境(RD/QA/PRODUCTION)、多个平台的所有配置
- 配置更新自动化：用户在平台更新配置，使用该配置的系统会自动发现该情况，并应用新配置。特殊地，如果用户为此配置定义了回调函数类，则此函数类会被自动调用。
配置异构系统管理
- 异构包部署统一化：这里的异构系统是指一个系统部署多个实例时，由于配置不同，从而需要多个部署包（jar或war）的情况（下同）。使用Disconf后，异构系统的部署只需要一个部署包，不同实例的配置会自动分配。特别地，在业界大量使用部署虚拟化（如JPAAS系统，SAE，BAE）的情况下，同一个系统使用同一个部署包的情景会越来越多，Disconf可以很自然地与他天然契合。
- 异构主备自动切换：如果一个异构系统存在主备机，主机发生挂机时，备机可以自动获取主机配置从而变成主机。
- 异构主备机Context共享工具：异构系统下，主备机切换时可能需要共享Context。可以使用Context共享工具来共享主备的Context。
极简的使用方式（注解式编程或 XML无代码侵入模式）：我们追求的是极简的、用户编程体验良好的编程方式。目前支持两种开发模式：基于XML配置或者基于注解，即可完成复杂的配置分布式化。

注：配置项是指某个类里的某个Field字段。

其它功能特点

低侵入性或无侵入性、强兼容性：
- 低侵入性：通过极少的注解式代码撰写，即可实现分布式配置。
- 无侵入性：通过XML简单配置，即可实现分布式配置。
- 强兼容性：为程序添加了分布式配置注解后，开启Disconf则使用分布式配置；若关闭Disconf则使用本地配置；若开启Disconf后disconf-web不能正常Work，则Disconf使用本地配置。
支持配置项多个项目共享，支持批量处理项目配置。
配置监控：平台提供自校验功能（进一步提高稳定性），可以定时校验应用系统的配置是否正确。

模块架构图

查看大图

模块信息

CLIENT: client目标是支持多语言。目前只提供了java语言客户端。
- JAVA
  - disconf-core: 分布式配置基础包模块
  - disconf-client: 分布式配置客户端模块, 依赖disconf-core包。用户程序使用它作为Jar包进行分布式配置编程。
  - disconf-tool: 分布式配置工具包，依赖disconf-core包。 Disconf-tool是disconf的辅助工具类, 目前使用不多，建议不使用。
管理端：disconf-web是统一的分布式配置管理平台。disconf-web: 分布式配置平台服务模块, 依赖disconf-core包。采用SpringMvc+纯HTML方式（前后端分离架构）实现。用户使用它来进行日常的分布式配置管理。

用户指南

clint

java client: disconf-client 使用

在您的 Maven POM 文件里加入：

<dependency><groupId>com.baidu.disconf</groupId><artifactId>disconf-client</artifactId><version>2.6.31</version>
</dependency>

server: disconf-web 使用

部署方法请参见：https://github.com/knightliao/disconf/tree/master/disconf-web

全新主页，高清大图：

APP+环境+版本+ZK查询：

java client Tutorials

总体概述

TutorialSummary 功能总体概述
文章介绍：分布式配置管理平台Disconf

基于注解式的分布式配置（支持配置文件和配置项）

推荐新建的项目使用disconf时使用

Tutorial 1 注解式分布式的配置文件
Tutorial 2 注解式分布式的配置文件高级篇: 配置更新的通知
Tutorial 3 注解式分布式的配置项
Tutorial 4 注解式分布式静态配置文件和静态配置项

注：将配置文件移至一个专有类里，而不是分散在项目的各个地方，整个代码架构清晰易懂、易管理。即便如果哪天不使用disconf，也只需要将注解去掉即可。

基于XML的分布式配置（无代码侵入）（仅支持配置文件）

推荐旧项目使用disconf时使用

Tutorial 8 基于XML的分布式配置文件管理,自动reload
Tutorial 5 基于XML的分布式配置文件管理,不会自动reload,对于那些比较重的资源如jdbc等，特别有用

demos

https://github.com/knightliao/disconf-demos-java

其它

Tutorial 6 disconf-web 功能详解
Tutorial 7 可自定义的部分托管的分布式配置
Tutorial disconf与dubbo的集成 demo
Tutorial 9 实现真正意义上的统一上线包
Tutorial 10 实现一个配置更新下载器agent
配置说明
异常考虑
局限性和注意事项
注意事项
Zookeeper异常考虑

详细设计和讨论

disconf-client详细设计文档
disconf-web详细设计文档
细节讨论

大家都在使用disconf

[百度]（20+条产品线使用）
滴滴打车
[银联]
网易
润生活（千万融资，全线产品使用）
拉勾网
人脉通（目前已B轮融资，4条产品线使用）
普联(Tp-link)技术有限公司
杭州数梦工场科技有限公司
众钱网
快速递
杭州同盾科技
杭州趣维科技 (数千万RMB A轮投资)
百世物流科技（在全国建立了400多个运作中心和250万平米的仓库及转运中心，拥有30000多员工和上万个认证加盟商及合作伙伴）
仙人掌股票（2015年度最火app,所有产品线已全面接入disconf）
更多

他人评价

快速递技术总监:

润生活总监：

人脉通后端RD：

开源中国社区：

「disconf」在「2015 年度新增开源软件排名 TOP 100(OSC开源中国提供)」中排名第16强。

群·联系·讨论

disconf技术QQ群: 239203866
媒体报道与网友教程

关于我

pfrock: A plugin-based server for running fake HTTP and socket services (especially SOA service) using Python.
搜索引擎推荐：sov5搜索引擎, 支持谷歌网页搜索和电影搜索
python论坛推荐：Django中国社区
我的微信：knightliao
我的简历
联系与赞助作者捐助者会留名

knightliao / disconf

Watch211 Star942 Fork505

Distributed Configuration Management Platform(分布式配置管理平台) — More...

Issues
#93	在哪可以自定义disconf.properties路径？	by gradysong 2016-04-30
#91	disconf-client是否可以支持Config类的继承？	by caokaifang 2016-04-28
#89	java.lang.IllegalArgumentException: wrong number of arguments	by bwzhang2011 2016-04-27
#88	可有计划增加对其他类型如json/yaml格式文件的支持	by GTaurus 2016-04-28
#87	急求disconf配置平台支持批量配置项	by m5jun 2016-04-22

master分支代码最近更新：2016-04-30

下载zip

Disconf最新更新资讯，共1条 (投递新闻)

Disconf —— 来自百度的分布式配置管理平台1年前0评/32阅

授权协议： apache2.0
开发语言： Java
操作系统：跨平台
收录时间： knightliao -> 2015年04月13日（国产软件 or 国人参与）