# 模块：ETCD

> Pigsty 可部署 etcd 模块，作为 DCS 为 PostgreSQL 高可用提供可靠的分布式配置存储支持。

---

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

---

ETCD 是一个分布式的、可靠的键-值存储，用于存放系统中最为关键的配置数据。

Pigsty 使用 [**etcd**](https://etcd.io/) 作为 [**DCS**](https://patroni.readthedocs.io/en/latest/dcs_failsafe_mode.html)（分布式配置存储），它对于 PostgreSQL 的高可用性与自动故障转移至关重要。

[`ETCD`](/docs/etcd) 模块依赖 [`NODE`](/docs/node) 模块，同时被 [`PGSQL`](/docs/pgsql) 模块依赖。因此在安装 [`ETCD`](/docs/etcd) 模块之前，您需要安装 [`NODE`](/docs/node) 模块将节点纳管。
在部署任何 [`PGSQL`](/docs/pgsql) 集群之前，你必须先部署一套 [`ETCD`](/docs/etcd) 集群，因为 PostgreSQL 高可用所需的 `patroni` 和 `vip-manager` 会依赖 etcd 实现高可用与 L2 VIP 主库绑定。

```mermaid
flowchart LR
    subgraph PGSQL [PGSQL]
        patroni[Patroni]
        vip[VIP Manager]
    end
    
    subgraph ETCD [ETCD]
        etcd[DCS 服务]
    end
    
    subgraph NODE [NODE]
        node[软件仓库]
    end
    
    PGSQL -->|依赖| ETCD -->|依赖| NODE
    
    style PGSQL fill:#3E668F,stroke:#2d4a66,color:#fff
    style ETCD fill:#5B9CD5,stroke:#4178a8,color:#fff
    style NODE fill:#FCDB72,stroke:#d4b85e,color:#333
    
    style patroni fill:#2d4a66,stroke:#1e3347,color:#fff
    style vip fill:#2d4a66,stroke:#1e3347,color:#fff
    style etcd fill:#4178a8,stroke:#2d5a7a,color:#fff
    style node fill:#d4b85e,stroke:#b89a4a,color:#333
```

在一套 Pigsty 部署中，只需要一套 etcd 集群。同一套 etcd 集群可以为多套 PostgreSQL 集群提供 DCS 服务支持。
Pigsty 中的 etcd 默认启用 RBAC，不同 PostgreSQL 集群使用独立的用户名与密码访问 etcd，从而实现多租户管理隔离。
管理员使用 etcd root 用户，拥有对所有 PostgreSQL 集群的管理权限。

---

本节页面：

- [集群配置](/zh/docs/etcd/config/): 根据需求场景选择合适的 Etcd 集群规模，并对外提供可靠的接入。
- [参数列表](/zh/docs/etcd/param/): ETCD 模块提供了 13 个配置参数，用于精细控制集群的行为表现。
- [管理预案](/zh/docs/etcd/admin/): etcd 集群管理 SOP：创建，销毁，扩缩容，更新配置，RBAC 配置的详细说明。
- [预置剧本](/zh/docs/etcd/playbook/): 如何使用预置的 ansible 剧本来管理 Etcd 集群，常用管理命令速查。
- [监控告警](/zh/docs/etcd/monitor/): etcd 监控面板，指标，以及告警规则。
- [指标列表](/zh/docs/etcd/metric/): Pigsty ETCD 模块提供的完整监控指标列表与释义
- [常见问题](/zh/docs/etcd/faq/): Pigsty etcd 模块常见问题答疑