Leader Election Examples

All examples require access to a Kubernetes cluster.

You can create a local cluster from the root using just start-test-cluster; requires docker, just and k3d.

Run an Example

cargo run --example <name>

Simple Lease - simple-lease.rs

This example creates a Kubernetes Lease based locking mechanism, acquires leadership and steps down after a few seconds.

Shared Lease - shared-lease.rs

A more sophisticated usage example with the leader election running in a background process that updates an AtomicBool inside an Arc.

Open up two shells and start a replica of the example in each of them. The first one will acquire the lock and be leading. The second one will be a follower. Now try to terminate the leading replica and wait at least 15 seconds to see the following acquiring the leadership.