# 如何在 etcd 集群中进行领导者选举

> 通过 etcdctl 客户端开展领导者选举的步骤

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

## 先决条件 {#prerequisites}

- 确保已安装 [`etcd`](/zh/docs/etcd/install/) 和 [`etcdctl`](/zh/docs/etcd/install/)。
- 检查 etcd 集群是否处于活跃状态。

## 进行领导者选举 {#conduct-leader-election}

`etcdctl` 命令用于在 etcd 集群中执行选举操作。该命令确保同一时间仅有一个客户端可成为领导者。

`etcdctl --endpoints=$ENDPOINTS elect <election-name> [proposal]`

```shell
etcdctl --endpoints=$ENDPOINTS elect election-name p1
```

### 选项 {#options}

- `--endpoints : $ENDPOINTS`

每个 etcd 集群成员的地址。

- `election-name` 字符串

用于选举的字符串标识符。所有竞争领导权的参与者必须使用相同的选举名称。

- `leader-name` 字符串

新领导者的提案值。

### 示例 {#example}

```shell
./etcdctl elect my-election proposal1
my-election/694d99fafea88404
proposal1

another election:
./etcdctl elect new-election proposal1
new-election/694d99fafea8840f
proposal1
```