README.md

uring  

RAFT spike based on the raft-rs framework that powers tikv/tidb to evaluate adopting raft-rs.

---

# start first node and clear current cache
rm -rf raft-rocks-*
cargo run -- -e 127.0.0.1:8081 -p 127.0.0.1:8082 -p 127.0.0.1:8083 -i1 -n --http 127.0.0.1:9081  -b -r 64
# join second node
cargo run -- -e 127.0.0.1:8082 -p 127.0.0.1:8081 -p 127.0.0.1:8083 -i2 -n --http 127.0.0.1:9082
# join third node
cargo run -- -e 127.0.0.1:8083 -p 127.0.0.1:8081 -p 127.0.0.1:8082 -i3 -n --http 127.0.0.1:9083
# activate nodes in raft group (triggers AddNode message)
curl -v -X POST http://127.0.0.1:9081/uring/2
curl -v -X POST http://127.0.0.1:9081/uring/3

# kill node 1
# restart node 1
cargo run -- -e 127.0.0.1:8081 -i 1 -p 127.0.0.1:8082
# kill new leader
# restart new leader
# kill  new leader
...

Alternate startup procedure

PYTHONPATH=. ./bin/3u.py # spin up a nascent 3-node test cluster

For dependencies ( if needed )

pip3 install -r ./requirements.txt

To output formatted pretty-printed json logs:

PYTHONPATH=. ./bin/3u.py 2>&1 | jq -R 'fromjson?'

Acceptance tests

go get -u github.com/landoop/coyote
PYTHONPATH=. bin/3u.py
coyote -c contrib/3u-test.yml

To view test report:

python -m SimpleHTTPServer
open http://localhost:8000/coyote.html

vnode

curl -H 'Content-Type: application/json' -X GET http://localhost:9081/mring
curl -H 'Content-Type: application/json' -X POST -d '{"size":64}' http://localhost:9081/mring
curl -H 'Content-Type: application/json' -X POST -d '{"node":"n1"}' http://localhost:9081/mring/node
curl -H 'Content-Type: application/json' -X GET http://localhost:9081/mring/node
curl -H 'Content-Type: application/json' -X POST -d '{"node":"n2"}' http://localhost:9081/mring/node

ws - kv

websocat ws://localhost:8081/uring

{"Select": {"rid": 1, "protocol": "KV"}}

{"Get": {"rid": 2, "key": "snot"}}

{"Put": {"rid": 3, "key": "snot", "store": "badger"}}

{"Get": {"rid": 2, "key": "snot"}}

{"Put": {"rid": 3, "key": "snot", "store": "badger2"}}

{"Delete": {"rid": 2, "key": "snot"}}

{"Get": {"rid": 2, "key": "snot"}}

{"Subscribe": {"channel": "kv"}}
{"As": {"protocol": "KV", "cmd": {"Get": {"rid": 2, "key": "snot"}}}}

{"As": {"protocol": "KV", "cmd": {"Put": {"rid": 3, "key": "snot", "store": "badger"}}}}

ws - mring

websocat ws://localhost:8081/uring

{"Select": {"rid": 1, "protocol": "MRing"}}

{"GetSize": {"rid": 2}}

{"SetSize": {"rid": 3, "size": 32}}

{"GetSize": {"rid": 2}}

{"AddNode": {"rid": 3, "node": "127.0.0.1:8181"}}
{"AddNode": {"rid": 3, "node": "127.0.0.1:8182"}}
{"AddNode": {"rid": 3, "node": "127.0.0.1:8183"}}

{"RemoveNode": {"rid": 3, "node": "127.0.0.1:8182"}}

ws - pubsub

websocat ws://localhost:8081/uring

{"Subscribe": {"channel": "kv"}}
{"Subscribe": {"channel": "mring"}}
{"Subscribe": {"channel": "uring"}}

ws - version

 websocat ws://127.0.0.1:8081/uring

{"Select": {"rid": 1, "protocol": "Version" }}
{"Selected":{"rid":1,"protocol":"Version"}}
{"Get": {"rid": 1}}
{"rid":1,"data":"0.1.0"}

ws - status

websocat ws://127.0.0.1:8081/uring

{"Select": {"rid": 1, "protocol": "Status" }}
{"Selected":{"rid":1,"protocol":"Status"}}
{"Get": {"rid": 1}}
{"rid":1,"data":{"election_elapsed":1,"id":1,"last_index":9,"pass_election_timeout":false,"promotable":true,"randomized_election_timeout":13,"role":"Leader","term":2}}

python client example

#!/usr/bin/env python3
import contrib
import time

rc = contrib.RaftClient()
rc.set_host('127.0.0.1')
rc.set_port(8081)
rc.ws_start()

def report(subject,json):
    print("{} Event: {}".format(subject, json))

time.sleep(1)
rc.subscribe('kv', lambda json: report('KV', json))
rc.subscribe('mring', lambda json: report('MRing', json))
rc.subscribe('uring', lambda json: report('URing', json))

while True:
    time.sleep(1)