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

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

主要目标：

  • 部署极其简单：同一个上线包，无须改动配置，即可在 多个环境中(RD/QA/PRODUCTION) 上线
  • 部署动态化：更改配置，无需重新打包或重启，即可 实时生效
  • 统一管理：提供web平台，统一管理 多个环境(RD/QA/PRODUCTION)、多个产品 的所有配置
  • 核心目标：一个jar包，到处运行

demos

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

项目信息

  • CLIENT 端：
  • Java: 目前唯一支持语言
  • python：打算支持
  • PHP：暂未支持
  • 开放API，让开发者具有自定义开发客户端的能力: Tutorial12 web开放API-client
  • WEB 管理端：
  • Java SpringMvc 实现，前后端分离 实现方式(基于Spring 4.1.7.RELEASE)
  • 开放API，让开发者具有自定义定制web控制台界面的能力 Tutorial12 web开放API

java client

disconf.git branches and Maven version:

  • dev(develop branch): 2.6.33-SNAPSHOT
  • master(stable branch)：2.6.32
  • 更新日志
  • 在Maven Central Repository里查看 com.baidu.disconf
Java Client Elegant Usage Preview
  • 注解式分布式配置使用方式
  • XML配置式分布式配置方式

功能特点

  • 支持配置（配置项+配置文件）的分布式化管理
  • 配置发布统一化
  • 配置发布、更新统一化:
  • 同一个上线包 无须改动配置 即可在 多个环境中(RD/QA/PRODUCTION) 上线
  • 配置存储在云端系统，用户统一管理 多个环境(RD/QA/PRODUCTION)、多个平台 的所有配置
  • 配置更新自动化：用户在平台更新配置，使用该配置的系统会自动发现该情况，并应用新配置。特殊地，如果用户为此配置定义了回调函数类，则此函数类会被自动调用。
  • 极简的使用方式（注解式编程 或 XML无代码侵入模式）：我们追求的是极简的、用户编程体验良好的编程方式。目前支持两种开发模式：基于XML配置或者基于注解，即可完成复杂的配置分布式化。

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

Disconf的功能特点描述图：

查看大图

其它功能特点

  • 低侵入性或无侵入性、强兼容性：
  • 低侵入性：通过极少的注解式代码撰写，即可实现分布式配置。
  • 无侵入性：通过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方式（前后端分离架构）实现。用户使用它来进行日常的分布式配置管理。

用户指南

client

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