raftdb
raftdb is a simple distributed key value store based on the Raft consensus protocol. It can be run on Linux, OSX, and Windows.
Running raftdb
Building raftdb requires Go 1.9 or later. gvm is a great tool for installing and managing your versions of Go.
Starting and running a raftdb cluster is easy. Download raftdb like so:
go get github.com/hanj4096/raftdb
Build raftdb like so:
cd $GOPATH/src/github.com/hanj4096/raftdb
go install
Bring up a cluster
Run your first raftdb node like so:
$GOPATH/bin/raftdb -id node01 -haddr raft-cluster-host01:8091 -raddr raft-cluster-host01:8089 ~/.raftdb
Let's bring up 2 more nodes, so we have a 3-node cluster. That way we can tolerate the failure of 1 node:
$GOPATH/bin/raftdb -id node02 -haddr raft-cluster-host02:8091 -raddr raft-cluster-host02:8089 -join raft-cluster-host01:8091 ~/.raftdb
$GOPATH/bin/raftdb -id node03 -haddr raft-cluster-host03:8091 -raddr raft-cluster-host03:8089 -join raft-cluster-host01:8091 ~/.raftdb
Reading and writing keys
You can now set a key and read its value back:
curl -XPOST raft-cluster-host01:8091/key -d '{"foo": "bar"}' -L
curl -XGET raft-cluster-host01:8091/key/foo -L
You can now delete a key and its value:
curl -XDELETE raft-cluster-host02:8091/key/foo -L
Three read consistency level
You can now read the key's value by different read consistency level:
curl -XGET raft-cluster-host02:8091/key/foo?level=stale
curl -XGET raft-cluster-host02:8091/key/foo?level=default -L
curl -XGET raft-cluster-host02:8091/key/foo?level=consistent -L