disconf-web 分布式配置管理平台

一、需求

实现分布式配置中心：
（1）集中管理外部依赖的服务配置和服务内部配置
（2）提供web管理平台进行配置和查询
（3）支持服务注册与发现
（4）支持客户端拉取配置
（5）支持订阅与发布，配置变更主动通知到client，实时变更配置

---

 二、开源解决方案

http://disconf.readthedocs.io/zh_CN/latest/index.html   disconf官方wiki文档及其他开源解决方案

注: disonf目前客户端只支持Java版本    https://github.com/knightliao/disconf-demos-java

 三、disconf-web部署

3.1  How to deploy

• 安装依赖软件

• • 安装Mysql（Ver 14.12 Distrib 5.0.45, for unknown-linux-gnu (x86_64) using EditLine wrapper）
  • 安装Tomcat（apache-tomcat-7.0.50）
  • 安装Nginx（nginx/1.5.3）
  • 安装 zookeeeper （zookeeper-3.3.0）
  • 安装 Redis （2.4.5）
• 从github获取disconf项目

[root@minion data]# git clone https://github.com/knightliao/disconf.git

• 目录结构说明

[root@minion data]# tree disconf -L 2
disconf
├── disconf-client       # 分布式配置客户端模块, 依赖disconf-core包。 用户程序使用它作为Jar包进行分布式配置编程。
│   ├── deploy
│   ├── pom.xml
│   ├── README.md
│   ├── src
│   └── tools
├── disconf-core        #分布式配置基础包模块
│   ├── pom.xml
│   ├── README.md
│   └── src
├── disconf-web     　　#分布式配置平台服务模块, 依赖disconf-core包。采用SpringMvc+纯HTML方式实现。 用户使用它来进行日常的分布式配置管理。
│   ├── bin
│   ├── deploy
│   ├── html
│   ├── pom.xml
│   ├── profile
│   ├── README.md
│   ├── sql        　 #初始化数据库sql文件
│   └── src
├── docs
│   ├── make.bat
│   ├── Makefile
│   ├── myMake.sh
│   ├── README.md
│   └── source
├── LICENSE
├── pom.xml
├── README.md
└── sql
16 directories, 13 files

• 配置准备

假定程序部署目录为:/data/disconf   配置模板文件路径为:/data/disconf/disconf-web/profile/rd

[root@minion disconf]# cd /data/disconf/    进入程序目录
[root@minion disconf]# mkdir -p /data/disconf/disconf-rd/{online-resources,war}　　#创建配置文件存放目录及war包存放路径,可自行设定目录
[root@minion disconf]# cd /data/disconf/disconf-web/profile/rd/    进入模板文件路径
[root@minion rd]# ls
application-demo.properties  jdbc-mysql.properties  log4j.properties  logback.xml  redis-config.properties  zoo.properties
[root@minion rd]# cp application-demo.properties jdbc-mysql.properties redis-config.properties zoo.properties /data/disconf/disconf-rd/online-resources/     #复制模板配置文件
[root@minion rd]# ll /data/disconf/disconf-rd/online-resources/
total 16
-rw-r--r-- 1 root root 419 Apr  8 15:54 application-demo.properties　　 #应用配置,邮件及应用相关
-rw-r--r-- 1 root root 370 Apr  8 15:54 jdbc-mysql.properties 　　　　　 #数据库配置
-rw-r--r-- 1 root root 498 Apr  8 15:54 redis-config.properties　　　　　#Redis配置，主要用于web登录使用
-rw-r--r-- 1 root root 130 Apr 8 15:54 zoo.properties 　　　　　　 　　　　#Zookeeper配置
[root@minion rd]# cd /data/disconf/disconf-rd/online-resources/
[root@minion online-resources]# cp application-demo.properties application.properties     #切记,将模板文件application-demo.properties复制成application.properties

• 注意，即使只有一个redis，也应该配置两个redis client，否则将造成内部错误。

[root@minion online-resources]# cat redis-config.properties 
redis.group1.retry.times=2

redis.group1.client1.name=BeidouRedis1
redis.group1.client1.host=127.0.0.1
redis.group1.client1.port=6379
redis.group1.client1.timeout=5000
redis.group1.client1.password=foobared

redis.group1.client2.name=BeidouRedis2
redis.group1.client2.host=127.0.0.1
redis.group1.client2.port=6380
redis.group1.client2.timeout=5000
redis.group1.client2.password=foobared

redis.evictor.delayCheckSeconds=300
redis.evictor.checkPeriodSeconds=30
redis.evictor.failedTimesToBeTickOut=6

• 项目构建

注: 安装前需确保mysql/tomcat/redis/zookeeper软件环境部署完成

[root@minion disconf]# ONLINE_CONFIG_PATH=/data/disconf/disconf-rd/online-resources
[root@minion disconf]# WAR_ROOT_PATH=/data/disconf/disconf-rd/war
[root@minion disconf]# export ONLINE_CONFIG_PATH
[root@minion disconf]# export WAR_ROOT_PATH
[root@minion disconf]# cd disconf-web
[root@minion disconf-web]# sh deploy/deploy.sh

脚本运行结束后会在/data/disconf/disconf-rd/war/路径下生成web部署所用到的程序文件

-disconf-web.war
-html
-META-INF
-WEB-INF

3.2 数据库初始化

可以参考 sql/readme.md 来进行数据库的初始化。注意sql文件导入顺序

0-init_table.sql---->1-init_data.sql---->201512/20151225.sql---->20160701/20160701.sql

数据库初始化完成后,里面默认有6个用户,可以使用默认的账号登陆disconf-web服务器页面（请注意线上环境删除这些用户以避免潜在的安全问题）

 

mysql> select * from disconf.user;
+---------+------------+------------------------------------------+------------------------------------------+---------+---------+   用户名对应的密码
| user_id | name       | password                                 | token                                    | ownapps | role_id |
+---------+------------+------------------------------------------+------------------------------------------+---------+---------+
|       1 | testUser1  | 5eec8499597a115c88e0a9580ae1562ab85d0b1a | b9070d385a13357efa09e50e080607c2b299241b | 2       |       1 |  -->MhxzKhl9209
|       2 | testUser2  | 71e9dc667eefa5a3a4840cb4f1ce22bc246f22f0 | b169dec42f61ec6cbad88d70e7c4c6b89630ccfb | 2       |       1 |  -->MhxzKhl167
|       3 | testUser3  | e2cdc4a9195030543e38e19a923f075d54471cc4 | a1a20b0e03a5191c530cbfc064eda3c16254df64 | 2       |       1 |  -->MhxzKhl783
|       4 | testUser4  | 5cef2d7e4ada5a615f03e12b569d80aedfb056fc | 007b07fccbc1c82c987f7b8e4651e85cca01cf2b | 2       |       1 |  -->MhxzKhl8758
|       5 | testUser5  | f996eeaa224abe0037d99adbce73c315e13238f9 | c9dfdcb50a3d84f2b6a4771dcb7c2ceb19e7d281 | 2       |       1 |  -->MhxzKhl112
|       6 | admin      | d033e22ae348aeb5660fc2140aec35850c4da997 | f28d164d23291c732f64134e6b7d92be3ff8b1b3 |         |       2 |  -->admin
|       7 | admin_read | b76f3e20d1c8d0bc17d40158e44097d5eeee8640 | 2022ab9c2754d62f9ddba5fded91e4238247ebaf | 2       |       3 |
|       8 | mobiledsp  | 0855b44a368e44dc6e6825532073b29a368584af | 132069654193f802203d1c6c86e753ecede698f6 | 4       |       1 |
+---------+------------+------------------------------------------+------------------------------------------+---------+---------+
8 rows in set (0.00 sec)
如果想自己设置初始化的用户名信息，可以参考代码来自己生成用户：
[root@minion disconf-web]# cat /data/disconf/disconf-web/src/main/java/com/baidu/disconf/web/tools/UserCreateTools.java    源代码文件

3.3 部署war包

修改tomcat中server.xml文件,在Host结点下设定Context：

[root@shuke conf]# vim /opt/apache-tomcat-9.0.0.M18/conf/server.xml
......
69　　<Connector port="8014" protocol="HTTP/1.1"      #设定端口为8014,可自行设定端口
70　　　　　　　　connectionTimeout="20000"
71　　　　　　　　redirectPort="8443" />
.......
148      <Host name="localhost"  appBase="webapps"
149            unpackWARs="true" autoDeploy="true">
150      <Context path="" docBase="/data/disconf/disconf-rd/war"></Context>     #增加内容

[root@shuke bin]# sh /opt/apache-tomcat-9.0.0.M18/bin/startup.sh  启动tomcat程序

3.4  部署前端nginx代理

[root@shuke conf.d]# cat /etc/nginx/conf.d/disconf.conf 
upstream disconf {
    server 127.0.0.1:8014;      #代理tomcat,动态请求转发至后端tomcat程序
}

server {

    listen   8081;
    server_name 192.168.1.100;     #如果使用域名,可以设置为disconf.com(可以自定义),但它必须与 application.properties配置文件中的domain保持一致。
    access_log /var/logs/disconf/access.log;
    error_log /var/logs/disconf/error.log;

    location / {
        root /data/disconf/disconf-rd/war/html;
        if ($query_string) {
            expires max;
        }
    }

    location ~ ^/(api|export) {
        proxy_pass_header Server;
        proxy_set_header Host $http_host;
        proxy_redirect off;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Scheme $scheme;
        proxy_pass http://disconf;
    }
    location = /favicon.ico {
        log_not_found off;
        access_log off;
    } 
}

浏览器访问:http://192.168.1.100:8081, 访问异常可查看nginx或tomcat日志

3.5 disconf-web使用说明

首页,点击登陆后,输入用户名:admin,密码:admin登陆即可

主界面

左上角可以选择APP和环境，选择之后，就会在中间出现若干个版本，

选择版本后，就会显示 APP、环境、版本 三个条件下的配置列表：

表格中 各个列的意义是：

• APP：使用哪个APP，及它的ID
• KEY：配置文件或配置项
• 配置内容：配置文件或配置项在配置中心中的值
• 实例列表：使用此配置文件或配置项的所有实例列表，及每个实例的配置值。如果实例的配置值与配置中心的值不一致，这里会标识出来。
• 修改时间：修改此配置的最后一次时间
• 操作：个性、删除、下载

右上角可以

新建配置项、新建配置文件、新建APP

表格右上方

可以批量下载所有配置文件至本地，还可以查看ZK上的部署情况。

至此,disconf-web端已经部署完成!

---

参考资料: http://disconf.readthedocs.io/zh_CN/latest/install/src/02.html