# 积木式架构 > Pigsty 的模块化架构介绍 —— 声明式组合，按需定制，自由部署。 --- LLMS index: [llms.txt](/llms.txt) --- Pigsty 使用 **模块化架构** 与 **声明式接口**，您可以像 [**搭积木一样自由按需组合模块**](/docs/deploy/planning#常见方案)。 * Pigsty 采用 [**模块化设计**](/docs/deploy/planning)，可自由组合，按需使用（Use one or all），以适应不同场景的需求。 * Pigsty 使用 [**配置清单**](/docs/concept/iac/inventory) 和 [**配置参数**](/docs/concept/iac/parameter) 描述整套部署环境，并通过 [**Ansible 剧本**](/docs/setup/playbook) 实现部署与调整。 * Pigsty 在可以在任意 [**节点**](/docs/concept/arch/node) 上运行，无论是物理裸机还是虚拟机，只要运行 [**兼容的操作系统**](/docs/ref/linux) 即可。 ---------------- ## 模块 Pigsty 采用模块化设计，有六个主要的默认模块：[`PGSQL`](/docs/pgsql)、[`INFRA`](/docs/infra)、[`NODE`](/docs/node)、[`ETCD`](/docs/etcd)、[`REDIS`](/docs/redis) 和 [`MINIO`](/docs/minio)。 * [**`PGSQL`**](/docs/pgsql)：由 Patroni、Pgbouncer、HAproxy、PgBackrest 等驱动的自治高可用 Postgres 集群。 * [**`INFRA`**](/docs/infra)：本地软件仓库、Nginx、Grafana、Victoria、AlertManager、Blackbox Exporter 可观测性全家桶。 * [**`NODE`**](/docs/node)：调整节点到所需状态、名称、时区、NTP、ssh、sudo、haproxy、docker、vector、keepalived * [**`ETCD`**](/docs/etcd)：分布式键值存储，用作高可用 Postgres 集群的 DCS：共识选主/配置管理/服务发现。 * [**`REDIS`**](/docs/redis)：Redis 服务器，支持独立主从、哨兵、集群模式，并带有完整的监控支持。 * [**`MINIO`**](/docs/minio)：与 S3 兼容的简单对象存储服务器，可作为 PG 数据库备份的可选目的地。 你可以声明式地自由组合它们。如果你想要主机监控，在基础设施节点上安装 [`INFRA`](/docs/infra) 模块，并在纳管节点上安装 [`NODE`](/docs/node) 模块就足够了。 [`ETCD`](/docs/etcd) 和 [`PGSQL`](/docs/pgsql) 模块用于搭建高可用 PG 集群，将模块安装在多个节点上，可以自动形成一个高可用的数据库集群。 您可以复用 Pigsty 基础架构并开发自己的模块，[`REDIS`](/docs/redis) 和 [`MINIO`](/docs/minio) 可作为样例。像 [PostgreSQL Mongo 模式](/docs/conf/mongo/) 这样的协议兼容层，则通过标准 PGSQL 与 Docker APP 工作流组合实现。 请注意，所有模块都强依赖 `NODE` 模块：在 Pigsty 中节点必须先安装 `NODE` 模块，被 Pigsty 纳管后方可部署其他模块。 当节点（默认）使用本地软件源进行安装时，`NODE` 模块对 `INFRA` 模块有弱依赖。因此安装 `INFRA` 模块的管理节点/基础设施节点会在 [`deploy.yml`](/docs/setup/playbook) 剧本中完成 Bootstrap 过程，解决循环依赖。 [![pigsty-sandbox](/img/pigsty/sandbox.png)](/docs/deploy/sandbox) ---------------- ## 单机安装 默认情况下，Pigsty 将在单个 **节点** (物理机/虚拟机) 上安装。[`deploy.yml`](https://github.com/pgsty/pigsty/blob/main/deploy.yml) 剧本将在 **当前** 节点上安装 [`INFRA`](/docs/infra)、[`ETCD`](/docs/etcd)、[`PGSQL`](/docs/pgsql) 和可选的 [`MINIO`](/docs/minio) 模块， 这将为你提供一个功能完备的可观测性技术栈全家桶（VictoriaMetrics、VictoriaLogs、VictoriaTraces、Grafana、Alertmanager、Blackbox Exporter 等），以及一个内置的 PostgreSQL 单机实例作为 CMDB，也可以开箱即用。（集群名 `pg-meta`，库名为 `meta`） 这个节点现在会有完整的自我监控系统、可视化工具集，以及一个自动配置有 PITR 的 Postgres 数据库（HA 不可用，因为你只有一个节点）。你可以使用此节点作为开发箱、测试、运行演示以及进行数据可视化和分析。或者，还可以把这个节点当作管理节点，部署纳管更多的节点！ [![pigsty-arch](/img/pigsty/arch.png)](/docs/infra/) ---------------- ## 监控 安装的 [单机元节点](#单机安装) 可用作 **管理节点** 和 **监控中心**，以将更多节点和数据库服务器置于其监视和控制之下。 Pigsty 的监控系统可以独立使用，如果你想安装 VictoriaMetrics / Grafana 可观测性全家桶，Pigsty 为你提供了最佳实践！ 它为 [主机节点](https://demo.pigsty.cc/d/node-overview) 和 [PostgreSQL数据库](https://demo.pigsty.cc/d/pgsql-overview) 提供了丰富的仪表盘。 无论这些节点或 PostgreSQL 服务器是否由 Pigsty 管理，只需简单的配置，你就可以立即拥有生产级的监控和告警系统，并将现有的主机与 PostgreSQL 纳入监管。 [![pigsty-dashboard.jpg](/img/pigsty/dashboard.jpg)](/docs/pgsql/dashboard/) ---------------- ## 高可用PG集群 Pigsty 帮助您在任何地方 **拥有** 您自己的生产级高可用 PostgreSQL RDS 服务。 要创建这样一个高可用 PostgreSQL 集群/RDS 服务，你只需用简短的配置来描述它，并运行剧本来创建即可： ```yaml pg-test: hosts: 10.10.10.11: { pg_seq: 1, pg_role: primary } 10.10.10.12: { pg_seq: 2, pg_role: replica } 10.10.10.13: { pg_seq: 3, pg_role: replica } vars: { pg_cluster: pg-test } ``` ```bash $ bin/pgsql-add pg-test # 初始化集群 'pg-test' ``` 不到10分钟，您将拥有一个服务接入，监控，备份 PITR，高可用配置齐全的 PostgreSQL 数据库集群。 [![pigsty-ha.png](/img/pigsty/ha.png)](/docs/concept/ha) 硬件故障由 patroni、etcd 和 haproxy 提供的自愈高可用架构来兜底，在主库故障的情况下，默认会在 45 秒内执行自动故障转移（Failover）。 客户端无需修改配置重启应用：Haproxy 利用 patroni 健康检查进行流量分发，读写请求会自动分发到新的集群主库中，并避免脑裂的问题。 这一过程十分丝滑，例如在从库故障，或主动切换（switchover）的情况下，客户端只有一瞬间的当前查询闪断， 软件故障、人为错误和数据中心级灾难由 pgBackRest 和可选的 [Silo](/docs/minio) 集群来兜底。这为您提供了本地/云端的 PITR 能力，并在数据中心失效的情况下提供跨地理区域复制与异地容灾功能。 --- Section pages: - [节点](/docs/concept/arch/node/): 节点（node）是对硬件资源/操作系统的抽象，可以是物理机，裸金属、虚拟机、或者容器与 pods。 - [INFRA 架构](/docs/concept/arch/infra/): Pigsty 中基础设施模块的架构，组件与功能详解。 - [PGSQL 架构](/docs/concept/arch/pgsql/): PostgreSQL 模块的组件交互与数据流。