Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ihaolin/diablo
分布式配置管理平台(Distributed Configuration Management Platform)
https://github.com/ihaolin/diablo
config-management distributed
Last synced: 2 months ago
JSON representation
分布式配置管理平台(Distributed Configuration Management Platform)
- Host: GitHub
- URL: https://github.com/ihaolin/diablo
- Owner: ihaolin
- License: mit
- Created: 2016-10-08T06:54:46.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-03-10T03:28:30.000Z (almost 8 years ago)
- Last Synced: 2024-08-03T06:02:10.657Z (6 months ago)
- Topics: config-management, distributed
- Language: Java
- Homepage:
- Size: 1.66 MB
- Stars: 343
- Watchers: 47
- Forks: 148
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
轻量的分布式配置管理平台[](https://travis-ci.org/ihaolin/diablo)
---
[English wiki](README_EN.md)。
在线Demo: 用户名/密码(admin/admin123).
## 一些特性
+ **轻量级**: 没有复杂的技术和第三方依赖;
+ **可靠存储**: 使用**Redis**作为存储，建议使用**Redis Cluster**，**Redis Master-Slave** 或者 **Redis Proxy Middleware**等技术保证存储的可靠性;
+ **对等的Server节点**: Server节点的对等性，保证即便某些Server不可用，集群仍能工作;
+ **近似实时更新**: diablo使用**Http长轮询**来保证客户端能及时得到配置更新的通知;
+ **简单的UI**: diablo内嵌了一个简单易用的web界面，叫做**Diablo Tower**;
+ ...
## Diablo架构
## Quick start
### 安装
+ [下载](https://github.com/ihaolin/diablo/releases)最新的压缩包；
+ 或者通过源码构建:
```bash
mvn clean package -DskipTests
# package located diablo-server/target/diablo-server-{version}.tar.gz
```
+ 解压缩包：
```bash
tar zxf diablo-server.tar.gz
ll diabloh
bin # the execute scripts
conf # conf dir
lib # dependency libs
```
+ 编辑配置文件**diablo.conf**：
```bash
# vim ${DIABLO_HOME}/conf/diablo.conf
# The server bind address
BIND_ADDR=127.0.0.1
# The server listening port
LISTEN_PORT=2143
# The redis host
REDIS_HOST=127.0.0.1
# The redis port
REDIS_PORT=6379
# The log path
LOG_PATH=~/logs/diablo
# The password for Diablo Tower admin
TOWER_PASS=admin
# The inverval(seconds) for checking server's status
CHECK_SERVER_INTERVAL=5
# Enable or disable client api auth
# client must config the appKey, if CLIENT_AUTH=true
CLIENT_AUTH=true
# Java Heap options
JAVA_HEAP_OPTS="-Xms512m -Xmx512m"
```
+ 启动或停止**diablo server**:
```bash
${DIABLO_HOME}/bin/diablo.sh start
${DIABLO_HOME}/bin/diablo.sh stop
${DIABLO_HOME}/bin/diablo.sh restart
```
### 使用 Diablo Tower
+ 启动**diablo server**后，便可通过Http访问**diablo tower**(如[http://127.0.0.1:2143](http://127.0.0.1:2143));
+ 事先准备**应用**和**配置项**：
+ 编辑应用:
+ 编辑配置项:
### 集成diablo client到应用中
+ 以下针对**Java客户端**，其他客户端可参考[该规范](CLIENT_API.md)。
+ [SimpleDiabloClient](diablo-client/src/main/java/me/hao0/diablo/client/SimpleDiabloClient.java)(**编程模式**):
+ 添加maven依赖:
```xml
me.hao0
diablo-client
1.2.3
```
+ 代码样例:
```java
SimpleDiabloClient client = new SimpleDiabloClient();
client.setAppName("myapp");
client.setAppKey("123456");
client.setServers("127.0.0.1:2143,127.0.0.1:2144");
// 可添加配置监听
client.addListener(new ConfigListener() {
@Override
public String name() {
// 配置项名称
return "test_config1";
}
@Override
public void onUpdate(String newValue) {
// 该方法会在本地配置更新后触发
System.out.println("test_config1 has updated to " + newValue);
}
});
client.start();
// 获取配置项最新的值
String testConfig = client.get("test_config");
// 获取配置项最新的json对象
MyClass myClass = client.get("test_json", MyClass.class);
client.shutdown();
```
+ 具体见[测试用例](diablo-client/src/test/java/me/hao0/diablo/client/SimpleDiabloClientTests.java).
+ [SpringDiabloClient](diablo-client-spring/src/main/java/me/hao0/diablo/client/SpringDiabloClient.java)(**Spring注入模式**):
+ 添加maven依赖:
```xml
me.hao0
diablo-client-spring
1.2.2
```
+ 配置片段:
```xml
```
+ 添加**diablo配置Bean**到**spring上下文中**, 如:
```java
@Component
public class MyAppConfig implements DiabloConfig {
// 支持基本类型转换
private String activityNo;
private Integer activityChannel;
private Boolean activityStart;
private Float activityRatio;
private Long activityCount;
private Double activityFee;
// 支持普通json对象转换
private TimeInfo timeInfo;
// 支持一级List对象转换
private List timeInfos;
// 支持一级Map对象转换
private Map timeInfoMap;
// getters and setters
}
```
+ 具体见[测试用例](diablo-client-spring/src/test/java/me/hao0/diablo/client/SpringDiabloClientTests.java).
+ 这样一旦你通过**Diablo Tower**修改了对应配置项时，客户端将收到通知。
## 有事请烧钱
+ 支付宝:
+ 微信:
