raft

README

Raft

Getting Started

package main

import (
	"github.com/shortlink-org/shortlink/pkg/raft"
)

func main() {
	r, err := raft.New(raft.Config{
		Name:     "node1",
		BindAddr: "localhost:8001",
	})
	if err != nil {
		panic(err)
	}

	r.Go(func() {
		// Do something
	})
}

Raft server states

stateDiagram-v2
  UNSPECIFIED --> Follower: times out, start election
  Follower    --> Candidate: times out, start election
  Candidate   --> Candidate: timeout, new election
  Candidate   --> Leader: win election
  Candidate   --> Follower: receive vote from majority

Docs

• The Raft Consensus Algorithm
  • In Search of an Understandable Consensus Algorithm (Extended Version)
• Implementing Raft
• Raft: Understandable Distributed Consensus
• GopherCon 2023: Philip O'Toole - Build Your Own Distributed System Using Go