diff --git a/content/en/docs/v3.5/tutorials/how-to-conduct-elections.md b/content/en/docs/v3.5/tutorials/how-to-conduct-elections.md index 6565a9d6..2fe520f1 100644 --- a/content/en/docs/v3.5/tutorials/how-to-conduct-elections.md +++ b/content/en/docs/v3.5/tutorials/how-to-conduct-elections.md @@ -4,13 +4,28 @@ description: Guide to conducting leader election in an etcd cluster weight: 900 --- + +## Prerequisites + +- Ensure [`etcd`](https://etcd.io/docs/v3.5/install/) and [`etcdctl`](https://etcd.io/docs/v3.5/install/) is installed. +- Check for active etcd cluster. + `elect` for leader election: -![09_etcdctl_elect_2016050501](https://storage.googleapis.com/etcd/demo/09_etcdctl_elect_2016050501.gif) +1. The `etcdctl` command is used to conduct leader elections in an etcd cluster. It makes sure that only one client become leader at a time. +2. Ensure the `ENDPOINTS` variable is set with the addresses of each etcd cluster members. +3. Set a unique name for the election for different clients ('one' in the given code below). +4. Lastly, set different leaders name for each clients (p1 and p2). + + + Command format : + `etcdctl --endpoints=$ENDPOINTS elect ` + + ```shell etcdctl --endpoints=$ENDPOINTS elect one p1 -# another client with the same name blocks +# another client with the same election name block etcdctl --endpoints=$ENDPOINTS elect one p2 ```