Skip to content

Latest commit

 

History

History

example

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Procfile
Procfile
 
 
README.md
README.md
 
 
gateway.go
gateway.go
 
 
kv_store.go
kv_store.go
 
 
main.go
main.go
 
 
raft.go
raft.go
 
 

README.md

raftexample

raftexample is an example usage of raft-foiver. It provides a simple REST API for a key-value store cluster backed by the Raft Consensus Algorithm. Inspired by etcd/contrib/raftexample.

Usage

Build

Clone raft-foiver.

cd raftexample
go build -o raftexample

Start a Three-Node Cluster

  1. Start Cluster
goreman start
  1. Add Key-Value
  • key: hello
  • value: world
curl -L http://127.0.0.1:9999/hello -X POST -d world
  1. Get Key-Value
curl -L http://127.0.0.1:9999/hello

Fault Tolerance

  1. Start Cluster and Add Key-Value (hello:world)
goreman start
curl -L http://127.0.0.1:9999/hello -X POST -d world
  1. Stop a Node and Update Key-Value (hello:foiver)
goreman run stop raftexample3
curl -L http://127.0.0.1:7777/hello -X POST -d foiver
curl -L http://127.0.0.1:7777/hello
  1. Restart Node and Check Key-Value (hello:foiver)
goreman run start raftexample3
curl -L http://127.0.0.1:9999/hello

Dynamic Cluster Reconfiguration

  1. Start Three-Node Cluster
goreman start
  1. Add New Node to Cluster
curl -L http://127.0.0.1:9999/4 -X PUT -d localhost:6000
raftexample --id 4 --addr localhost:6000 --peerids 1,2,3 --peeraddrs localhost:7000,localhost:8000,localhost:9000 --port 6666 --join
  1. Test Cluster
curl -L http://127.0.0.1:9999/hello -X POST -d world
curl -L http://127.0.0.1:6666/hello
  1. Remove Node from Cluster
curl -L http://127.0.0.1:9999/2 -X DELETE