raftd

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 13)

raftd 基于raft和bolt的分布式KV数据库由于简单实现了租约系统可以用于简单的服务发现基于gin框架提供http服务

raftd Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# raftd
raftd 基于`raft`算法，支持数据持久化(bolt)的分布式KV数据库，可以用于简单的服务发现，基于gin框架提供http服务

## Usage

``` sh
cd cmd/raftd

go build

./raftd -id node01 -haddr 127.0.0.1:8001 -raddr 127.0.0.1:8101 ~/.raftd01

./raftd -id node02 -haddr 127.0.0.1:8002 -raddr 127.0.0.1:8102 -join 127.0.0.1:8001 ~/.raftd02

./raftd -id node03 -haddr 127.0.0.1:8003 -raddr 127.0.0.1:8103 -join 127.0.0.1:8001 ~/.raftd03
```

``` sh
curl -X PUT 127.0.0.1:8001/key/test -T ./test.png

curl 127.0.0.1:8001/key/test --output 1.png
```

> 步骤：

1. 启动的时候只make() 然后 调用 tx.ForEach() 遍历整个 db 建立缓存
2. 更新/删除 KV 的时候同步更新缓存
3. 集群同步的时候 直接使用 Store.m 进行数据传输

> 节点同步的步骤：

1. 先 fsm.db.Close() 然后 截断 data.db
2. 重新建立 db bolt.Open(...)
3. range snapshot.m 然后执行一个 Batch Update 将数据同步到 fsm.db 和 fsm.m 中
4. TODO 失败的情况

## 租约系统(可以用于服务发现)

### Usage

获取租约并续租
``` sh
# 服务1
ID=$(curl -sL -XPOST 127.0.0.1:8001/lease/grant\?ttl=10\&name=/esq/node-1);while true;do curl -sL -XPOST 127.0.0.1:8001/lease/keepalive/$ID -d 'key=nodeinfo' -d 'data={"http_addr":"127.0.0.1:9001","tcp_addr":"127.0.0.1:9002","node_id":1,"weight":1}';sleep 3;done

# 服务2
ID=$(curl -sL -XPOST 127.0.0.1:8001/lease/grant\?ttl=10\&name=/esq/node-2);while true;do curl -sL -XPOST 127.0.0.1:8001/lease/keepalive/$ID -d 'key=nodeinfo1' -d 'data={"http_addr":"127.0.0.1:9003","tcp_addr":"127.0.0.1:9004","node_id":2,"weight":2}';sleep 3;done
```

获取键值对

``` sh
curl -sL -XPOST 127.0.0.1:8001/lease/kv/nodeinfo -d 'prefix=/esq/node'
```

### 实现原理

1. 创建一个DefaultLeaseBucketName的Bucket
2. 用雪花算法生成一个LeaseId，这个Id作为一个子桶，里面存放共享这个租约的键值对，注意有一个Key是不允许覆写的，KeyName为 `meta`，存放当前租约的元数据，包括 LeaseTTL LeaseAliveCount LeaseStatus LeaseName
3. 启动一个 goroutine 每秒检测当前租约的状态，一旦有客户端租用了当前租约，租约的状态就从 CREATE 转为 ALIVE，并且给租约中的所有键值对的TTL减去一，在操作完所有的键值对后，统计TTL不为0的AliveCount，如果AliveCount==0，撤销当前租约(退出当前goroutine,删除这个LeaseId的子桶)
4. 续租：客户端在申请完租约后，会从服务端获取租约号，使用租约号可以续租，一旦续租，对应租约中的对应键值对的TTL会重新置为这个租约的TTL(从 `meta` 中获取)

### TODO
- 申请了却从不租用的租约该怎么处理？这些租约的状态为CREATE，如果每次同步状态机时全部重启loopCheck，会消耗一定的资源，如果同步的时候直接删除这些租约属实 鸭子睁眼——大可不必 了，目前有一个可能的解决方案是 PutInPool

- TimeToLive API

- 存放租约的树换成LSM-Tree，KV系统属于读多写少，租约系统属于读写都比较多，每秒会有多个协程更新整棵树，可以考虑为租约系统单独做一个存储引擎，准备参考<https://github.com/dgraph-io/badger/tree/v1.0.0>,这个库比较成熟，值得借鉴

- 关于 LSM Tree 存放租约 key 应该设计为 LeaseID value 设计为 metaSize(4bytes)valueSize(4bytes)meta(struct_json_bytes)value(map_json_bytes) TODO:考虑使用某个更高性能的json库

raftd

raftd Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

raftd

raftd Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README