Diamond详解(1)-配置

原文：http://my.oschina.net/u/435621/blog/270483?p=1

大家好，今天开始为大家带来我们通用产品团队的产品 —— diamond的专题，本次为大家介绍diamond的概况和快速使用。

一、概况

diamond是淘宝内部使用的一个管理持久配置的系统，它的特点是简单、可靠、易用，目前淘宝内部绝大多数系统的配置，由diamond来进行统一管理。

diamond为应用系统提供了获取配置的服务，应用不仅可以在启动时从diamond获取相关的配置，而且可以在运行中对配置数据的变化进行感知并获取变化后的配置数据。

持久配置是指配置数据会持久化到磁盘和数据库中。

diamond的特点是简单、可靠、易用：

简单：整体结构非常简单，从而减少了出错的可能性。

可靠：应用方在任何情况下都可以启动，在承载淘宝核心系统并正常运行一年多以来，没有出现过任何重大故障。

易用：客户端使用只需要两行代码，暴露的接口都非常简单，易于理解。

二、快速使用

1、源代码检出

从以下svn地址检出diamond的源代码：

http://code.taobao.org/svn/diamond/trunk

2、server的搭建

（1）mysql

安装mysql-server的步骤请参考mysql官方文档，安装完毕后，建立数据库，然后建立两张表，建表语句分别如下：

[sql]  view plain  copy

1. create table config_info (  
2. `id` bigint(64) unsigned NOT NULL auto_increment,  
3. `data_id` varchar(255) NOT NULL default ’ ’,  
4. `group_id` varchar(128) NOT NULL default ’ ’,  
5. `content` longtext NOT NULL,  
6. `md5` varchar(32) NOT NULL default ’ ’,  
7. `src_ip` varchar(20) default NULL,  
8. `src_user` varchar(20) default NULL,  
9. `gmt_create` datetime NOT NULL default ’2010-05-05 00:00:00′,  
10. `gmt_modified` datetime NOT NULL default ’2010-05-05 00:00:00′,  
11. PRIMARY KEY  (`id`),  
12. UNIQUE KEY `uk_config_datagroup` (`data_id`,`group_id`)  
13. );  
14. create table group_info (  
15. `id` bigint(64) unsigned NOT NULL auto_increment,  
16. `address` varchar(70) NOT NULL default ’ ’,  
17. `data_id` varchar(255) NOT NULL default ’ ’,  
18. `group_id` varchar(128) NOT NULL default ’ ’,  
19. `src_ip` varchar(20) default NULL,  
20. `src_user` varchar(20) default NULL,  
21. `gmt_create` datetime NOT NULL default ’2010-05-05 00:00:00′,  
22. `gmt_modified` datetime NOT NULL default ’2010-05-05 00:00:00′,  
23. PRIMARY KEY  (`id`),  
24. UNIQUE KEY `uk_group_address` (`address`,`data_id`,`group_id`)  
25. );  

建表完成后，请将数据库的配置信息添加到diamond-server工程的src/resources/jdbc.properties文件中。

（2）tomcat

tomcat是diamond server的运行容器。

tomcat的安装请参考tomcat官方文档，建议使用tomcat7

不需要对tomcat进行任何改动。

（3）diamond server

在diamond-server源代码根目录下，执行mvn clean package -Dmaven.test.skip，成功后会在diamond-server/target目录下生成diamond-server.war（如果没有安装maven，请参考maven官方文档进行安装）。

打包完成后，将diamond-server.war放在tomcat的webapps目录下。

（4）http server

http server用来存放diamond server等地址列表，可以选用任何http server，这里以tomcat为例。

安装tomcat的步骤请参开tomcat官方文档，注意，如果http server和diamond server安装在一台机器上，请修改http server的端口，避免冲突。

修改完端口后，请将diamond-utils工程下的com.taobao.diamond.common.Constants类中的DEFAULT_PORT常量修改成对应的端口号。

安装完成后，请在tomcat的webapps下建立文件夹diamond-server和pushit-server，diamond-server中再建立diamond文件，文件内容是diamond-server的地址列表，一行一个地址，地址为ip；pushit-server中也建立diamond文件，文件内容是pushit-server的地址列表，一行一个地址，地址为ip:port（pushit后文会进行叙述）

（5）pushit

pushit是一个轻量级的消息通知服务组件，用来为diamond做实时通知服务，通知客户端数据的变化，它也是CS的结构，服务端搭建步骤如下：

在pushit源代码根目录下，执行mvn clean package assembly:assembly -Dmaven.test.skip命令，成功后会在pushit/target目录中看到pushit-pushit.tar.gz包。

执行tar -xzvf  pushit-pushit.tar.gz，进行解压。

进入pushit目录，建立logs目录，在logs目录中建立pushit.log文件。

进入pushit/bin目录，执行./pushit-startup.sh ../conf/server.properties命令，启动pushit-server

（6）redis

redis用来存放一些跟统计相关的信息。

redis的安装请参考redis的官方文档。

安装完成后，请在diamond-server的配置文件redis.properties中填写对应的信息。

完成以上6步后，server端的搭建就完成了。

2、发布数据

diamond发布数据通过手工的方式进行。

修改diamond-server的配置文件user.properties，以k=v的方式添加登录diamond-server的用户名和密码。

在浏览器中输入http://ip:port/diamond-server/，ip和port为server搭建的第（2）步中的地址和端口，登录后进入后台管理界面，然后点击“配置信息管理”—— “添加配置信息”，在输入框中输入dataId、group、内容，最后点击“提交”即可。

成功后，可以在“配置信息管理”中查询到发布的数据。

3、订阅数据

diamond客户端API主要提供了订阅数据的功能.

（1）客户端获取服务端地址

获取服务端地址对客户端是透明的，客户端仅仅需要在本地进行如下域名绑定即可：

domain  ip

其中，domain的值与diamond-utils工程下的com.taobao.diamond.common.Constants类中的DEFAULT_DOMAINNAME和DAILY_DOMAINNAME的值相同，ip为server搭建第（4）步中的http server地址。

（2）创建订阅者

DiamondManager manager = new DefaultDiamondManager(group, dataId, new ManagerListener() {

public void receiveConfigInfo(String configInfo) {

// 客户端处理数据的逻辑

}

});

参数的说明：

group和dataId为String类型，二者结合为diamond-server端保存数据的惟一key

ManagerListener 是客户端注册的数据监听器， 它的作用是在运行中接受变化的配置数据，然后回调receiveConfigInfo()方法，执行客户端处理数据的逻辑。如果要在运行中对变化的配置数据进行处理，就一定要注册ManagerListener

（3）获取配置数据

String configInfo = manager.getAvailableConfigInfomation(timeout);

diamond-server端保存的配置全都为文本类型，返回给客户端的配置数据为java.lang.String类型，timeout为从网络获取配置数据的超时时间。客户端调用每次调用该方法，都能够保证获取一份最新的可用的配置数据。