raftdb is a simple distributed key value store based on the Raft consensus protocol. It can be run on Linux, OSX, and Windows.
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/raftdbBuild raftdb like so:
cd $GOPATH/src/github.com/hanj4096/raftdb
go installRun your first raftdb node like so:
$GOPATH/bin/raftdb -id node01 -haddr raft-cluster-host01:8091 -raddr raft-cluster-host01:8089 ~/.raftdbLet'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 ~/.raftdbYou can now set a key and read its value back:
curl -X POST raft-cluster-host01:8091/key -d '{"foo": "bar"}' -L
curl -X GET raft-cluster-host01:8091/key/foo -LYou can now delete a key and its value:
curl -X DELETE raft-cluster-host02:8091/key/foo -LYou can now read the key's value by different read consistency level:
curl -X GET raft-cluster-host02:8091/key/foo?level=stale
curl -X GET raft-cluster-host02:8091/key/foo?level=default -L
curl -X GET raft-cluster-host02:8091/key/foo?level=consistent -L