A Raft implementation without log compaction or membership changes.
The core code itself is in server. client contains a rather trivial client designed to test the server. For testing one can use
Kubernetes, for which a script is provided in launch-tool/launch.py. Please not that launch.py hardcodes a bunch of
assumptions about how pods are created, about the fact that we are running under minikube, and that the image itself is
named local/raft-peer. As such one can adopt this script for other purposes, but this will need some work.
Steps to Launch:
-
Go into the '/launch-tool' directory and run
pip3 install -r requirements.txtto get all the required dependencies. -
Start up Minikube by running
./boot.sh -
To use Kubernetes with this project use
./create-docker-image.shto first create a Docker image. Then:
./launch.py boot <num peers>will boot a cluster withnum peersparticipants. Each participant is given a list of all other participants (so you can connect to them)../launch.py listlists all peers in the current cluster. You can usekubectl logs <name>to access the log for a particular pod../launch.py kill <n>can be used to kill the nth pod../launch.py launch <n>can be used to relaunch the nth pod (e.g., after it is killed)../launch.py shutdownwill kill all pods, shutting down the cluster../launch.py client-url <n>can be used to get the URL for the nth pod. One example use of this is./client $(../launch-tool/launch.py client-url 1)to get a client to connect to pod 1.