Skip to content
/ disconf Public
forked from nabilzhang/disconf

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

License

Notifications You must be signed in to change notification settings

jart/disconf

 
 

Repository files navigation

Disconf Build Status Coverage Status Codeship Status for knightliao/disconf

Distributed Configuration Management Platform

分布式配置管理平台

项目信息

  • Java项目(1.6+)
  • Maven管理(3.0.5+)

Disconf当前最新版本:

  • 开发最新版:disconf-client 2.6.13-SNAPSHOT
  • 稳定版本: disconf-client 2.6.12
  • 更新日志

在Maven Central Repository里查看 com.baidu.disconf

它是什么?

  • 命名为Disconf
  • 专注于各种系统的配置管理的通用组件/通用平台
  • 百度研发

Disconf可以为各种业务平台提供统一的配置管理服务。

目前正在百度各大业务系统广泛推广。

当前版本(2.6.12)功能特点

  • 支持配置(配置项+配置文件)的分布式化管理
  • 配置发布统一化
  • 注解式编程,极简的使用方式
  • 支持Spring方式编程
  • 低侵入性和强兼容性

未来版本(完全版)功能特点

重要功能特点

  • 支持配置(配置项+配置文件)的分布式化管理
  • 配置发布统一化
    • 配置发布、更新统一化(云端存储、发布):配置存储在云端系统,用户统一在平台上进行发布、更新配置。
    • 配置更新自动化:用户在平台更新配置,使用该配置的系统会自动发现该情况,并应用新配置。特殊地,如果用户为此配置定义了回调函数类,则此函数类会被自动调用。
  • 配置异构系统管理
    • 异构包部署统一化:这里的异构系统是指一个系统部署多个实例时,由于配置不同,从而需要多个部署包(jar或war)的情况(下同)。使用Disconf后,异构系统的部署只需要一个部署包,不同实例的配置会自动分配。特别地,在业界大量使用部署虚拟化(如百度的JPASS系统,SAE,BAE)的情况下,同一个系统使用同一个部署包的情景会越来越多,Disconf可以很自然地与他天然契合。
    • 异构主备自动切换:如果一个异构系统存在主备机,主机发生挂机时,备机可以自动获取主机配置从而变成主机。
    • 异构主备机Context共享工具:异构系统下,主备机切换时可能需要共享Context。可以使用Context共享工具来共享主备的Context。
  • 注解式编程,极简的使用方式:我们追求的是极简的、用户编程体验良好的编程方式。通过简单的标注+极简单的代码撰写,即可完成复杂的配置分布式化。
  • 支持Spring方式和非Spring方式编程:用户可以自行选择编程习惯,是否采用Spring方式进行编程。推荐Spring编程方式。

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

Disconf的功能特点描述图:

查看大图

其它功能特点

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

模块架构图

查看大图

模块信息##

  • disconf
    • disconf-core: 分布式配置基础包模块
    • disconf-client: 分布式配置客户端模块, 依赖disconf-core包。 用户程序使用它作为Jar包进行分布式配置编程。
    • disconf-tool: 分布式配置工具包,依赖disconf-core包。 Disconf-tool是disconf的辅助工具类。
    • disconf-web: 分布式配置平台服务模块, 依赖disconf-core包。采用SpringMvc+纯HTML方式实现。 用户使用它来进行日常的分布式配置管理。
  • demo

用户指南

用户请关注这里。

概述

Disconf为应用方提供了三个工具,

  1. disconf-client, 您可以在您的应用系统里加入此Jar包;
  2. disconf-web, 它是一个Web平台,您可以此Web平台上管理您的配置。
  3. disconf-tool,可选包。

disconf-client 使用

在您的 Maven POM 文件里加入:

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

主要依赖为:

  • Spring(3.1.2+)
  • Zookeeper(3.3.6)
  • Jedis(2.1.0
  • reflections(0.9.9-RC1)
  • gson(2.2.4)
  • guava(16.0)
  • wiremock(1.4.6, test)
  • jmockit(15.0, test)

disconf-web 使用

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

disconf-client Tutorials

开发人员指南

其它

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 73.7%
  • Java 17.3%
  • JavaScript 6.7%
  • PHP 1.2%
  • CSS 0.8%
  • Smarty 0.1%
  • Other 0.2%