奇虎360 QConf 配置管理工具安装使用文档

分布式配置管理系统QConf安装使用文档

QConf 是奇虎 360 内部分布式配置管理工具。用来替代传统的配置文件，使得配置信息和程序代码分离，同时配置变化能够实时同步到客户端，而且保证用户高效读取配置，这使的工程师从琐碎的配置修改、代码提交、配置上线流程中解放出来，极大地简化了配置管理工作。

QConf架构图

详见：https://github.com/Qihoo360/QConf

一、由于QConf使用了cmake编译工具，先安装cmake（操作系统：CentOS6_64位）

1、安装gcc等必备程序包（已安装则略过此步）：

yum install -y gcc gcc-c++ make automake

2、安装wget（已安装则略过此步）：

yum install -y wget

3、当前cmake版本为3.5.1，获取cmake编译好的二进制包：

wget --no-check-certificate https://cmake.org/files/v3.5/cmake-3.5.1-Linux-x86_64.tar.gz

4、解压cmake二级制包：

tar -zxvf cmake-3.5.1-Linux-x86_64.tar.gz

5、将cmake目录下的bin目录加入到环境变量：

vim /etc/profile

##加入环境变量
CMAKE=/opt/cmake-3.5.1-Linux-x86_64
PATH=$PATH:$CMAKE/bin

6、重新加载profile：

source /etc/profile

7、测试一下cmake命令是否可用：

cmake

二、采用源码编译安装方式安装QConf（当前开源最新版本为1.1.0）：

github下载地址：https://github.com/Qihoo360/QConf/releases

下载并解压后进入根目录，进行cmake编译：

mkdir build && cd build
cmake ..
make
make install

如果编译过程中没有报错，在命令行下就可以执行测试一下了：

qconf

到此qconf已经安装完成了。

三、安装zookeeper（单机模式）

下载并解压zookeeper（版本为3.4.6）：http://mirrors.cnnic.cn/apache/zookeeper/zookeeper-3.4.6/zookeeper-3.4.6.tar.gz

解压后进入conf目录，将zoo_sample.cfg文件重命名为zoo.cfg

启动zookeeper：

./bin/zkServer.sh start

查看zookeeper运行状态：

./bin/zkServer.sh status

四、配置QConf：

在不修改QConf默认安装路径的情况下，QConf安装目录为：/usr/local/qconf

在QConf 配置文件中配置Zookeeper集群地址：

vim /usr/local/qconf/conf/idc.conf

由于我在本机测试所以qconf去zookeeper在同一机器，以下配置：

############################################################################
#                             QCONF config                                 #
############################################################################
# all the zookeeper host configuration.
#[zookeeper]
zookeeper.test=127.0.0.1:2181

五、启动QConf：

进入qconf目录：

cd /usr/local/qconf/bin

执行启动命令：

sh agent-cmd.sh start

六、简单测试：

1、通过zookeeper自带客户端插入数据：

##进入zookeeper的bin目录下执行
./zkCli.sh
create /demo demo
create /demo/confs confs
create /demo/confs/conf1 test-conf1
create /demo/confs/conf2 test-conf2
create /demo/confs/conf3 test-conf3

2、通过qconf默认客户端获取配置的值：

获取conf1的值

qconf get_conf /demo/confs/conf1

获取配置列表：

qconf get_batch_keys /demo/confs

至此QConf的安装与简单测试已经完成，后续补充java对接使用方法。