Pigsty v3.7.0 文档

• 1: 安装
  • 1.1: 快速上手
  • 1.2: 用户界面
  • 1.3: 多节点部署
  • 1.4: 离线安装
  • 1.5: 精简安装
  • 1.6: 视频演示
• 2: 准备
  • 2.1: 硬件置备
  • 2.2: Linux 系统
  • 2.3: 软件置备
  • 2.4: 管理用户
  • 2.5: 沙箱环境
  • 2.6: Vagrant
  • 2.7: Terraform
• 3: 配置
  • 3.1: 清单
  • 3.2: 配置
  • 3.3: 教程
  • 3.4: 模板
  • 3.5: 安全
  • 3.6: CMDB
• 4: 管理
  • 4.1: Ansible
  • 4.2: 剧本
  • 4.3: Nginx 入口
  • 4.4: 本地软件源
  • 4.5: DNS 域名
  • 4.6: SSL 证书
• 5: 关于
  • 5.1: 作者
  • 5.2: 开源协议
  • 5.3: 社区
  • 5.4: 新闻
  • 5.5: 漏洞
  • 5.6: 路线
• 6: 价值主张
  • 6.1: 可扩展性
  • 6.2: 可依赖性
  • 6.3: 可观测性
  • 6.4: 可伸缩性
  • 6.5: 可维护性
  • 6.6: 可组合性
  • 6.7: 可控制性
  • 6.8: 可承担性
• 7: 关键特性
  • 7.1: PG 扩展
  • 7.2: PG 内核分支
  • 7.3: 可观测性基础设施
  • 7.4: 高可用性
  • 7.5: 灾难恢复
  • 7.6: 基础设施即代码
  • 7.7: 无容器
  • 7.8: 应用模板
  • 7.9: Supabase
  • 7.10: 本地优先
• 8: 参考
  • 8.1: PG 发行版
  • 8.2: RDS 替代
  • 8.3: 整体架构
  • 8.4: 技术对比
  • 8.5: 模块
  • 8.6: FAQ
• 9: 版本
  • 9.1: Pigsty 发布
  • 9.2: 最新版本
  • 9.3: 测试版本
  • 9.4: PIG 发布
  • 9.5: PG Exporter
  • 9.6: RPM 发布
  • 9.7: DEB 发布
  • 9.8: INFRA 发布
• 10: 服务
• 11: PostgreSQL
  • 11.1: 架构
  • 11.2: 配置
  • 11.3: 参数
  • 11.4: 管理
    • 11.4.1: 参数优化
    • 11.4.2: 维护保养
    • 11.4.3: 故障排查
    • 11.4.4: 误删处理
  • 11.5: 剧本
  • 11.6: 监控
  • 11.7: 答疑
  • 11.8: 用户
  • 11.9: 数据库
  • 11.10: 服务
  • 11.11: 认证
  • 11.12: 权限
  • 11.13: 面板
  • 11.14: 迁移
  • 11.15: 备份
    • 11.15.1: 备份机制
    • 11.15.2: 备份仓库
    • 11.15.3: 备份策略
    • 11.15.4: 备份管理
    • 11.15.5: 时间点恢复
    • 11.15.6: 示例
  • 11.16: 内核
    • 11.16.1: PostgreSQL
    • 11.16.2: Citus
    • 11.16.3: Babelfish
    • 11.16.4: IvorySQL
    • 11.16.5: Percona
    • 11.16.6: PolarDB
    • 11.16.7: OrioleDB
    • 11.16.8: OpenHalo
    • 11.16.9: Cloudberry
    • 11.16.10: Supabase
    • 11.16.11: FerretDB
  • 11.17: 扩展
    • 11.17.1: 快速开始
    • 11.17.2: 软件包
    • 11.17.3: 下载
    • 11.17.4: 安装
    • 11.17.5: 配置
    • 11.17.6: 创建
    • 11.17.7: 更新
    • 11.17.8: 移除
• 12: 基础设施
  • 12.1: 架构
  • 12.2: 配置
  • 12.3: 参数
  • 12.4: 管理
  • 12.5: 剧本
  • 12.6: 监控
  • 12.7: FAQ
• 13: 节点
  • 13.1: 架构
  • 13.2: 配置
  • 13.3: 参数
  • 13.4: 管理
  • 13.5: 剧本
  • 13.6: 监控
  • 13.7: FAQ
• 14: ETCD
  • 14.1: 配置
  • 14.2: 参数
  • 14.3: 管理预案
  • 14.4: 剧本
  • 14.5: 监控
  • 14.6: 常见问题
• 15: MinIO
  • 15.1: 使用
  • 15.2: 集群配置
  • 15.3: 参数
  • 15.4: 管理
  • 15.5: 剧本
  • 15.6: 监控
  • 15.7: FAQ
• 16: Redis
  • 16.1: 配置
  • 16.2: 参数
  • 16.3: 管理
  • 16.4: 剧本
  • 16.5: 监控
  • 16.6: FAQ
• 17: FERRET
  • 17.1: 使用方法
  • 17.2: 配置
  • 17.3: 参数
  • 17.4: 管理
  • 17.5: 剧本
  • 17.6: 监控
• 18: Docker
  • 18.1: 配置
  • 18.2: 参数
  • 18.3: 管理
  • 18.4: 剧本
  • 18.5: 监控
  • 18.6: FAQ
• 19: APP
  • 19.1: 剧本
  • 19.2: pgAdmin
  • 19.3: Supabase
  • 19.4: Odoo
  • 19.5: Dify

    为什么使用 Pigsty？Pigsty 的 8 条核心价值主张

    核心特性、亮点和技术细节

    架构、用例、对比和其他参考资料

    许可证、发布、社区、新闻、作者、服务等...

curl -fsSL https://repo.pigsty.io/get | bash -s v3.7.0; cd ~/pigsty;  # 下载安装 Pigsty
./configure    # 生成配置文件
./install.yml  # 执行安装部署

    在 Linux 服务器上安装 Pigsty

    为正式部署准备环境

    使用配置清单自定义数据库集群

    使用 Ansible 剧本管理您的环境

    具有高可用、PITR、IaC、ACL、监控和 437 扩展的 HA PG 集群

    Nginx、软件仓库、DNS、NTP、Prometheus 和 Grafana 可观测性技术栈

    将节点注册到所需状态并监控，以及 VIP、HAProxy

    可靠的分布式共识存储（DCS），为 PGSQL 高可用提供支持

    S3 兼容的对象存储，可选的备份存储

    高性能内存缓存，可选的数据结构服务器

    容器运行时，可选，用于运行无状态应用和工具

    将你的 PostgreSQL 封装为一套 MongoDB！

    Pigsty 是一个 PostgreSQL 数据库发行版，本地优先的开源 RDS 云数据库解决方案。Pigsty 不是数据库（DBMS），而是管理数据库的工具，解决方案，与最佳实践。属于 RDS/DBA 赛道。类比：数据库是车，那么 DBA 是司机，RDS 是出租车服务，Pigsty 则是自动驾驶软件。

    用好数据库的能力极为稀缺：要么高薪聘请数据库专家自建（雇司机），或从云厂商以天价租赁 RDS（打车），但现在你有新的选项：Pigsty（自动驾驶）。Pigsty 帮用户用好数据库：让用户在没有 DBA 的情况下，以不到 RDS 1/10 的成本，自建质量效率更优的本地云数据库服务！

    Pigsty 沉淀了顶尖专家在最复杂，最大规模的甲方 PostgreSQL 场景中打磨得到的经验与最佳实践，产品化为可复制的软件：一次性解决扩展安装，高可用，链接池，监控，备份恢复，参数优化，IaC 批量管理，一键安装，自动化运维等诸多问题。提前规避诸多陷阱，避免重复踩坑。

    Pigsty 提供远超 RDS 的特性集与基础设施支持，包括 400+ 扩展插件与 8+ 内核支持，提供独一无二的监控系统，与久经复杂场景打磨考验的架构最佳实践，简单易用。且用探探，苹果，阿里等顶级甲方场景打磨而成，用激情与热爱持续浇灌，深度与成熟度绝非 RDS 大锅饭可比。

    Pigsty 允许您使用 10 ¥/核·月的纯硬件资源，运行 400¥-1400¥/核·月的 RDS 云数据库，并省去 DBA 的工资。通常，成规模的 Pigsty 部署总拥有成本（TCO）能比 RDS 低 90% 以上。Pigsty 能够同时降低软件许可/服务/人力的开销，自建无需加人，让您将成本花在刀刃上。

    Pigsty 整合了 PG 生态最全的扩展（400+），提供了 All in PG 解决方案：单一组件替代 Redis, Kafka, MySQL, ES, 向量数据库, OLAP / 大数据分析等专用组件。极大提高研发效能与敏捷性的同时降低复杂度成本，而且研发能在 Pigsty 的加持下实现自助管理，自主 DevOps，无需 DBA

    Pigsty 故障自愈的高可用架构确保硬件故障无需当场处理，让运维与 DBA 睡个好觉；监控助力问题分析与性能优化；IaC 赋能超大规模集群自动化管理。运维在 Pigsty 加持下能兼职 DBA ，而 DBA 则可以跳过系统建设阶段，节省大量工时并专注于高价值工作，或喝茶看报，学习PG。

    Pigsty 主体由冯若航一人开发，这是一位专注于 PostgreSQL 领域 10 年的开源贡献者，数据库专家与布道师，曾任职于阿里，探探，苹果，全栈专家。现为一人公司创始人，提供专业咨询服务。同时他也是技术 KOL，微信数据库个人公众号榜首 《非法加冯》 的主理人，全网粉丝六万+

    Pigsty 是 OSSRANK PG 生态开源榜单中国人主导项目的第一名，同时也是 PostgreSQL 生态最活跃的开源项目之一，目前在扩展分发与监控系统上占据碾压性优势。Pigsty 目前是云厂商 RDS 的挑战者，目前已经广泛应用于军工，政企，医疗，互联网，金融，制造业等各个行业。

    Pigsty 源于超大规模 PostgreSQL 自动化管理的需求，但已针对易用性进行深度优化，缺乏专业 DBA 能力的个人开发者与中小型企业也可以轻松上手使用。最大规模部署为 25K vCPU，450万QPS，六年+，最小规模部署可完整运行于 1c1g 虚拟机上作为 Demo / Devbox 使用

    Pigsty 专注于整合 PostgreSQL 生态，提供 PostgreSQL 的最佳实践，但同时也支持一系列与 PostgreSQL 配合良好的开源软件。例如 Etcd, Redis, MinIO, DuckDB, Prometheus, FerretDB, Babelfish, IvorySQL, PolarDB, OrioleDB, OpenHalo, Supabase, Greenplum, Dify, Odoo,...

    运行大规模 PostgreSQL 集群用于业务；自建 RDS，对象存储，缓存，数仓，Supabase, …；自建 Odoo，Dify，Wiki，GitLab 等企业级应用；运行监控基础设施，监控现有数据库与主机；同时组合使用多种PG扩展插件；大屏开发与交互式数据应用 Demo，数据可视化，Web 建站

    Pigsty 是 100% 的开源软件 + 自由软件，使用 AGPLv3 许可证开源。在遵循开源许可证的前提下，您可以将其免费地，自由的用于各种商业目的。我们珍视软件自由，对于非 DBaaS / OEM 用例，我们执行更为宽松的等效 Apache 2.0 许可证。请参阅许可证以获取更多详细信息。

    Pigsty 软件本身开源免费，并提供丰俭由人的商业订阅，为 Pigsty & PostgreSQL 提供质保。订阅提供更宽广的 OS/PG/芯片架构支持范围，以及专家咨询与支持。Pigsty 商业订阅交付业界顶尖的管理/技术经验/解决方案，帮助您节省宝贵的时间，替您扛雷，并为疑难杂症兜底。

    Pigsty 软件本身不属于数据库，不受信创名录限制，且已有多个部队用例。但 Pigsty 开源版不提供任何形式的信创支持，商业版订阅提供与阿里云合作的国产信创解决方案，支持使用具有信创资质的 PolarDB-O （需单独采购）作为 RDS 内核，能够运行于信创操作系统/芯片环境。

    您可以在遵循 AGPLv3 许可证 —— 开源全部衍生工作的前提下将其用于此目的。我们保留对公有云/数据库厂商违反 AGPLv3 许可证进行追责的权利。如果您不希望开源衍生作品，建议您选购 Pigsty 企业版订阅计划，那里提供对此用例的清晰授权以及对 AGPLv3 开源义务的豁免。

1 - 安装

快速开始

快速开始：准备 一台具有 SSH访问权限 的 节点，新安装 Linux系统， 使用具有免密 ssh 和 sudo 权限的用户运行：

使用以下命令[**下载**](/zh/docs/prepare/software#pigsty) pigsty：

```bash
curl -fsSL https://repo.pigsty.io/get | bash -s v3.7.0; cd ~/pigsty;
```

执行 [`configure`](/zh/docs/config/configure) 生成 [配置清单](/zh/docs/config/inventory)。（<span class="text-red-500 font-black">务必修改</span> 生成的 [`pigsty.yml`](/zh/docs/config/inventory) 中的密码）

```bash
./configure
```

一键 [**安装部署**](/zh/docs/install/start) 所有组件：

```bash
./install.yml
```

Pigsty 安装完成！请探索 用户界面，访问 5432 端口上的 Postgres 服务，或 3000 端口上的 Grafana 监控大盘（admin / pigsty）。

下一步做什么？

• 访问 Postgres 服务
• 探索 Grafana 仪表盘
• 创建业务数据库 和 用户
• 添加更多节点实现真正的高可用
• 获取更多 PostgreSQL 扩展

安装

    在当前 Linux 节点上，执行标准的完整在线安装流程

    在多个节点上安装，以实现真正的企业级高可用部署

    在没有互联网连接的情况下，从本地离线包引导安装

    仅安装高可用 Postgres 集群所必须的组件，不装监控

准备工作

    准备节点、网络、存储、用户、ssh、sudo、ansible 等

    检查兼容的 Linux 发行版和可用性矩阵

    使用 vagrant / virtualbox 置备本地 Linux 虚拟机

    在云供应商上使用 terraform 置备云 Linux 服务器

参考

    访问和管理 Pigsty 提供的数据库端点与图形用户界面

    使用声明式的配置文件描述你需要的基础设施与集群

    了解可用的 Ansible 剧本和其使用方法

    生产环境的安全加固和最佳实践

1.1 - 快速上手

本文是 Pigsty 单节点安装指南，多节点安装 介绍了在生产环境进行真正高可用部署的方法。

简化版本

准备 一台具有 SSH权限 的 节点 并安装 兼容的Linux发行版， 使用带免密 ssh 和 sudo 权限的用户：

    [**下载**](#download) pigsty，它会自动安装至 `~/pigsty` 目录，并尝试安装 [`ansible`](/zh/docs/admin/ansible)：

    ```bash
    curl -fsSL https://repo.pigsty.io/get | bash -s v3.7.0; cd ~/pigsty;
    ```

    使用 [`configure`](/docs/config/configure) 生成配置文件，或直接根据您的需求调整 [`pigsty.yml`](/zh/docs/config/inventory)：

    ```bash
    ./configure   # 可以使用 -c [conf] 指定具体的配置模板
    ```

    使用 `install.yml` 剧本，一键 [**安装部署**](#install) 所有组件：

    ```bash
    ./install.yml
    ```

示例：在 RockyLinux 9 上的单机安装：

准备

安装 Pigsty 涉及一些 准备工作 ，以下是简略检查清单：

下载

（推荐）您可以使用以下命令获取并解压最新稳定版本的 pigsty 源码：

curl -fsSL https://repo.pigsty.io/get | bash -s v3.7.0; cd ~/pigsty

curl -fsSL https://repo.pigsty.cc/get | bash -s v3.7.0; cd ~/pigsty   # 中国镜像

curl -fsSL https://repo.pigsty.io/get | bash -s v3.7.0; cd ~/pigsty

您也可以通过 git、pig 或直接从 GitHub 下载源码 和 离线软件包 压缩包的方式安装。

• pigsty/
  • configure
  • install.yml
  • pigsty.yml

配置

configure 脚本将根据您的环境和输入生成具有良好默认值的 pigsty.yml 配置文件 配置清单。 这是 可选的，您可以如 教程 所示直接编辑 pigsty.yml。

有许多 配置模板 供您参考，以下是一些快速示例：

./configure                  # 使用默认模板，安装默认的 PG 18，带有必要扩展
./configure -v 17            # 使用 PG 17 的版本，而非默认的 PG18
./configure -c rich          # 创建本地软件仓库，下载所有扩展，安装主要扩展
./configure -c slim          # 最小安装模板，与 ./slim.yml 剧本一起使用
./configure -c app/supa      # 使用 app/supa 自托管 supabase 配置模板
./configure -c ivory         # 使用 ivorysql 内核而非原生 PG
./configure -i 10.11.12.13   # 显式指定主 IP 地址
./configure -r china         # 使用中国镜像而非默认仓库
./configure -c full -s       # 使用 4 节点沙箱配置模板，不进行 IP 替换和探测

让我们不带任何参数执行 configure，如果发现多个 IP 地址，它可能会要求您输入主 IP 地址。

[vagrant@node-2 pigsty]$ ./configure
configure pigsty v3.7.0 begin
[ OK ] region  = default
[ OK ] kernel  = Linux
[ OK ] machine = x86_64
[ OK ] package = rpm,dnf
[ OK ] vendor  = rocky (Rocky Linux)
[ OK ] version = 9 (9.6)
[ OK ] sudo = vagrant ok
[ OK ] ssh = [email protected] ok
[WARN] Multiple IP address candidates found:
    (1) 192.168.121.24	inet 192.168.121.24/24 brd 192.168.121.255 scope global dynamic noprefixroute eth0
    (2) 10.10.10.12	    inet 10.10.10.12/24 brd 10.10.10.255 scope global noprefixroute eth1
[ IN ] INPUT primary_ip address (of current meta node, e.g 10.10.10.10):
=> 10.10.10.12    # <------- 在这里输入你的首要 IPv4 地址！
[ OK ] primary_ip = 10.10.10.12 (from input)
[ OK ] admin = [email protected] ok
[ OK ] mode = meta (el9)
[ OK ] locale  = C.UTF-8
[ OK ] configure pigsty done
proceed with ./install.yml

该脚本将把 IP 占位符 10.10.10.10 替换为当前节点的主 IPv4 地址。 在 手动 配置 pigsty 时请注意这一点。检查生成的 pigsty.yml 以继续。

嘿！别忘了这些密码！

然后修改默认 密码 并进行必要的调整，最终的 pigsty.yml 可能如下所示：

all:

  #==============================================================#
  # Clusters, Nodes, and Modules
  #==============================================================#
  children:

    #----------------------------------------------#
    # PGSQL : https://doc.pgsty.com/pgsql
    #----------------------------------------------#
    # this is an example single-node postgres cluster with pgvector installed, with one biz database & two biz users
    pg-meta:
      hosts:
        10.10.10.10: { pg_seq: 1, pg_role: primary } # <---- primary instance with read-write capability
        #x.xx.xx.xx: { pg_seq: 2, pg_role: replica } # <---- read only replica for read-only online traffic
        #x.xx.xx.xy: { pg_seq: 3, pg_role: offline } # <---- offline instance of ETL & interactive queries
      vars:
        pg_cluster: pg-meta

        # install, load, create pg extensions: https://doc.pgsty.com/pgsql/extension
        pg_extensions: [ postgis, pgvector ]

        # define business users/roles : https://doc.pgsty.com/pgsql/user
        pg_users:
          - { name: dbuser_meta ,password: DBUser.Meta   ,pgbouncer: true ,roles: [dbrole_admin   ] ,comment: pigsty admin user }
          - { name: dbuser_view ,password: DBUser.Viewer ,pgbouncer: true ,roles: [dbrole_readonly] ,comment: read-only viewer  }

        # define business databases : https://doc.pgsty.com/pgsql/db
        pg_databases:
          - name: meta
            baseline: cmdb.sql
            comment: "pigsty meta database"
            schemas: [pigsty]
            # define extensions in database : https://doc.pgsty.com/pgsql/extension/create
            extensions: [ postgis, vector ]

        # define HBA rules : https://doc.pgsty.com/pgsql/hba
        pg_hba_rules:
          - { user: dbuser_view , db: all ,addr: infra ,auth: pwd ,title: 'allow grafana dashboard access cmdb from infra nodes' }

        # define backup policies: https://doc.pgsty.com/pgsql/backup
        node_crontab: [ '00 01 * * * postgres /pg/bin/pg-backup full' ] # make a full backup every day 1am

        # define (OPTIONAL) L2 VIP that bind to primary
        #pg_vip_enabled: true
        #pg_vip_address: 10.10.10.2/24
        #pg_vip_interface: eth1


    #----------------------------------------------#
    # INFRA : https://doc.pgsty.com/infra
    #----------------------------------------------#
    infra:
      hosts:
        10.10.10.10: { infra_seq: 1 }
      vars:
        repo_enabled: false   # disable in 1-node mode :  https://doc.pgsty.com/admin/repo
        #repo_extra_packages: [ pg18-main ,pg18-time ,pg18-gis ,pg18-rag ,pg18-fts ,pg18-olap ,pg18-feat ,pg18-lang ,pg18-type ,pg18-util ,pg18-func ,pg18-admin ,pg18-stat ,pg18-sec ,pg18-fdw ,pg18-sim ,pg18-etl]

    #----------------------------------------------#
    # ETCD : https://doc.pgsty.com/etcd
    #----------------------------------------------#
    etcd:
      hosts:
        10.10.10.10: { etcd_seq: 1 }
      vars:
        etcd_cluster: etcd
        etcd_safeguard: false             # prevent purging running etcd instance?

    #----------------------------------------------#
    # MINIO : https://doc.pgsty.com/minio
    #----------------------------------------------#
    #minio:
    #  hosts:
    #    10.10.10.10: { minio_seq: 1 }
    #  vars:
    #    minio_cluster: minio
    #    minio_users:                      # list of minio user to be created
    #      - { access_key: pgbackrest  ,secret_key: S3User.Backup ,policy: pgsql }
    #      - { access_key: s3user_meta ,secret_key: S3User.Meta   ,policy: meta  }
    #      - { access_key: s3user_data ,secret_key: S3User.Data   ,policy: data  }

    #----------------------------------------------#
    # DOCKER : https://doc.pgsty.com/docker
    # APP    : https://doc.pgsty.com/app
    #----------------------------------------------#
    # launch example pgadmin app with: ./app.yml (http://10.10.10.10:8885 [email protected] / pigsty)
    app:
      hosts: { 10.10.10.10: {} }
      vars:
        docker_enabled: true                # enabled docker with ./docker.yml
        docker_registry_mirrors: ["https://docker.1panel.live","https://docker.1ms.run","https://docker.xuanyuan.me","https://registry-1.docker.io"]
        app: pgadmin                        # specify the default app name to be installed (in the apps)
        apps:                               # define all applications, appname: definition
          pgadmin:                          # pgadmin app definition (app/pgadmin -> /opt/pgadmin)
            conf:                           # override /opt/pgadmin/.env
              PGADMIN_DEFAULT_EMAIL: [email protected]
              PGADMIN_DEFAULT_PASSWORD: pigsty


  #==============================================================#
  # Global Parameters
  #==============================================================#
  vars:

    #----------------------------------------------#
    # INFRA : https://doc.pgsty.com/infra
    #----------------------------------------------#
    version: v3.7.0                   # pigsty version string
    admin_ip: 10.10.10.10             # admin node ip address
    region: china                     # upstream mirror region: default|china|europe
    proxy_env:                        # global proxy env when downloading packages
      no_proxy: "localhost,127.0.0.1,10.0.0.0/8,192.168.0.0/16,*.pigsty,*.aliyun.com,mirrors.*,*.myqcloud.com,*.tsinghua.edu.cn"
      # http_proxy:  # set your proxy here: e.g http://user:[email protected]
      # https_proxy: # set your proxy here: e.g http://user:[email protected]
      # all_proxy:   # set your proxy here: e.g http://user:[email protected]
    infra_portal:                     # domain names and upstream servers
      home         : { domain: h.pigsty }
      grafana      : { domain: g.pigsty ,endpoint: "${admin_ip}:3000" , websocket: true }
      prometheus   : { domain: p.pigsty ,endpoint: "${admin_ip}:9058" }
      alertmanager : { domain: a.pigsty ,endpoint: "${admin_ip}:9059" }
      blackbox     : { endpoint: "${admin_ip}:9115" }
      loki         : { endpoint: "${admin_ip}:3100" }
      pgadmin      : { domain: adm.pigsty ,endpoint: "${admin_ip}:8885" }
      #minio       : { domain: m.pigsty ,endpoint: "${admin_ip}:9001" ,scheme: https ,websocket: true }

    #----------------------------------------------#
    # PASSWORD : https://doc.pgsty.com/config/security
    #----------------------------------------------#
    grafana_admin_password: pigsty               # <-------- CHANGE ME!
    pg_admin_password: DBUser.DBA                # <-------- CHANGE ME!
    pg_monitor_password: DBUser.Monitor          # <-------- CHANGE ME!
    pg_replication_password: DBUser.Replicator   # <-------- CHANGE ME!
    patroni_password: Patroni.API                # <-------- CHANGE ME!
    haproxy_admin_password: pigsty               # <-------- CHANGE ME!
    minio_secret_key: minioadmin                 # <-------- CHANGE ME!

    #----------------------------------------------#
    # NODE : https://doc.pgsty.com/node/param
    #----------------------------------------------#
    nodename_overwrite: false             # do not overwrite node hostname on single node mode
    node_tune: tiny                       # node tuning specs: oltp,olap,tiny,crit
    node_etc_hosts: [ '10.10.10.10 h.pigsty a.pigsty p.pigsty g.pigsty sss.pigsty' ]
    node_repo_modules: 'node,infra,pgsql' # add these repos directly to the singleton node
    #node_repo_modules: local             # use this if you want to build & user local repo
    node_repo_remove: true                # remove existing node repo for node managed by pigsty
    #node_packages: [openssh-server]      # packages to be installed current nodes with the latest version

    #----------------------------------------------#
    # PGSQL : https://doc.pgsty.com/pgsql/param
    #----------------------------------------------#
    pg_version: 18                      # default postgres version
    pg_locale: C.UTF-8                  # overwrite default C local
    pg_lc_collate: C.UTF-8              # overwrite default C lc_collate
    pg_lc_ctype: C.UTF-8                # overwrite default C lc_ctype

    pg_conf: tiny.yml                   # pgsql tuning specs: {oltp,olap,tiny,crit}.yml
    pg_safeguard: false                 # prevent purging running postgres instance?
    pg_packages: [ pgsql-main, pgsql-common ]                 # pg kernel and common utils
    #pg_extensions: [ pg18-time ,pg18-gis ,pg18-rag ,pg18-fts ,pg18-olap ,pg18-feat ,pg18-lang ,pg18-type ,pg18-util ,pg18-func ,pg18-admin ,pg18-stat ,pg18-sec ,pg18-fdw ,pg18-sim ,pg18-etl]

pg_extensions: [ pg18-time ,pg18-gis ,pg18-rag ,pg18-fts ,pg18-olap ,pg18-feat ,pg18-lang ,pg18-type ,pg18-util ,pg18-func ,pg18-admin ,pg18-stat ,pg18-sec ,pg18-fdw ,pg18-sim ,pg18-etl]

安装

Pigsty 中的一切都由 配置清单 所定义，也就是 上面 生成的 pigsty.yml 配置。

运行 install.yml 剧本 会实施这个部署计划。

./install.yml

输出尾部如果带有 pgsql init done，PLAY RECAP 等字样，说明安装已经完成！

......

TASK [pgsql : pgsql init done] *************************************************
ok: [10.10.10.11] => {
    "msg": "postgres://10.10.10.11/postgres | meta  | dbuser_meta dbuser_view "
}
......

TASK [pg_monitor : load grafana datasource meta] *******************************
changed: [10.10.10.11]

PLAY RECAP *********************************************************************
10.10.10.11                : ok=302  changed=232  unreachable=0    failed=0    skipped=65   rescued=0    ignored=1
localhost                  : ok=6    changed=3    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0

上游仓库（如 Linux / PGDG 仓库）可能会因为更新而进入崩溃状态并导致安装失败（有过多次先例）！ 您可以选择等待上游仓库修复后安装，或者使用预制的 离线软件包 来解决这个问题。

安装完成后，您可以探索 用户界面，纳管 更多节点 并部署更多高可用数据库集群。

更多

您可以使用 pigsty 部署和监控 更多集群：向 配置清单 添加定义并运行：

bin/node-add pg-test    # 初始化集群 pg-test 的 3 个节点
bin/pgsql-add pg-test   # 初始化高可用 PGSQL 集群 pg-test
bin/redis-add redis-ms  # 初始化 redis 集群 redis-ms

记住，大多数模块都需要先安装 NODE 模块。查看可用的 模块 了解详情

PGSQL、INFRA、NODE、ETCD、 MINIO、REDIS、FERRET、DOCKER……

1.2 - 用户界面

安装完成后，您在当前节点上将安装有四个核心模块： PGSQL、INFRA、NODE 和 ETCD。

您可以直接通过以下 端口 直接访问 WebUI 服务（不推荐用于生产环境）。 或使用本地/公共 域名 通过 Nginx 门户 访问它们。

请注意，SSL 证书 需要与域名一起使用。

您可以通过以下数据库用户和相应的 PGURL 访问默认端口 5432 上的默认 PostgreSQL 数据库（meta）：

psql postgres://dbuser_dba:[email protected]:5432/meta

psql postgres://dbuser_meta:[email protected]:5432/meta

psql postgres://dbuser_view:[email protected]:5432/meta

PostgreSQL

个人用户开发测试使用时，可以直接使用默认超级用户和 IP:端口来访问 PostgreSQL：

DBSU

CLI

内置的 psql CLI 已经为管理员用户（安装 Pigsty 使用的用户）配置了 .pgpass 和 .pg_service.conf

p   # 别名：操作系统管理员用户 @ 当前节点

psql postgres://dbuser_dba:[email protected]/postgres  # 替换为您的 IP 和密码

GUI

您可以使用您喜欢的 GUI 工具来访问数据库，Pigsty 也提供了一些 GUI 工具的内置模板。

默认设置

您可以定义业务 数据库 和 用户。配置模板 中有一些预定义的示例供您参考。

例如，默认的 meta 配置模板预定义了一个 meta 数据库：

• 带有 Pigsty CMDB 模式（可选）
• 预装来 timescaledb, postgis, citus, pgvector 四个业务扩展
• 它定义了 dbuser_meta 作为具有 DDL 权限的业务管理员用户，和一个 dbuser_view 作为只读查看者用户。

pg-meta:
  hosts:
    10.10.10.10: { pg_seq: 1, pg_role: primary } # <---- 这个集群中只有一个实例，主库
  vars:
    pg_cluster: pg-meta                 # 必选参数，集群名

    pg_databases:                       # 数据库列表
      - name: meta
        baseline: cmdb.sql
        comment: "pigsty meta database"
        schemas: [pigsty]
        extensions: [ postgis, timescaledb, vector ]   # 安装了三个扩展

    pg_users:                           # 数据库用户列表
      - { name: dbuser_meta ,password: DBUser.Meta   ,pgbouncer: true ,roles: [dbrole_admin   ] ,comment: pigsty admin user }
      - { name: dbuser_view ,password: DBUser.Viewer ,pgbouncer: true ,roles: [dbrole_readonly] ,comment: read-only viewer  }

    pg_hba_rules:                       # example hba rules
      - {user: dbuser_view , db: all ,addr: infra ,auth: pwd ,title: 'allow grafana dashboard access cmdb from infra nodes'}

这意味着您也可以使用这两个用户访问 meta 数据库：

psql postgres://dbuser_meta:[email protected]:5432/meta

psql postgres://dbuser_view:[email protected]:5432/meta

生产环境

要在生产环境中使用高可用 PostgreSQL 集群，您需要阅读以下文档来继续：

• 特性：PostgreSQL 高可用性
• 服务：访问 Postgres 集群

在这种情况下，您的流量在到达数据库之前会通过 haproxy 进行分发，并由 pgbouncer 池化。

Grafana

Grafana 是监控和可观测性平台，提供可视化面板能力，默认监听 3000 端口：

• http://10.10.10.10:3000（替换为您的 IP）

您可以查看我们的公共演示站点来看看它是什么样子： https://g.pgsty.com

1.3 - 多节点部署

你可以参考 配置教程 ，将一个单机 Pigsty 节点逐步扩展为多节点高可用部署。 但是完成这些工作最简单的办法，始终是在部署前就预先规划一切，并且一次性完成整个环境的置备。

单节点部署

我们已经在 快速上手 一节中演示了单节点安装的流程 —— 最简单的部署方式。

单节点没有高可用性，也没有冗余，如果您确实要将其用于生产环境，请为 PG 配置外部 MinIO / S3 / NFS… 作为远程备份仓库，这样能提供最低数据完整性灾难恢复能力。

Pigsty 有很多单节点 配置模板 供您参考。 你可以使用 Vagrant 默认的 meta.rb 来在本地置备此环境所需的虚拟机。 或者使用 Terraform 默认的 meta.tf 来在阿里云上置备此环境。

双节点部署

半高可用设置

双节点设置可实现一主一从的数据库物理复制和半高可用功能：

虽然比单节点设置更加健壮，但双节点架构的高可用性有限制：

• 如果 node-2 故障，自动故障转移正常工作 - node-1 会自动被提升
• 如果 node-1 故障，无法进行自动故障切换 - 需要手动提升 node-2

也就是说，这种"半高可用"设置只能从 特定的节点故障 中自动恢复，只允许坏其中一台特定的节点2。

您可以使用 dual.yml 配置模板，并使用 Vagrant dual.rb 来置备此环境所需的虚拟机。

三节点部署

真正的高可用

一个能够从任意单节点故障中自动恢复的真正高可用设置：

您可以使用 trio.yml 配置模板，并使用 Vagrant trio.rb 来置备此环境所需的虚拟机。

四节点沙箱

这是 Pigsty 中使用的 沙箱演示 环境，具有一个基础设施节点和三个额外的数据节点：

您可以使用 full.yml 配置模板，并使用 Vagrant full.rb 或 Terraform full.tf 来置备此环境。

五节点构建

这个 pro.yml 是一个五节点构建环境，包含支持的 Linux 发行版。

您可以使用 Vagrant pro.rb 或 Terraform pro.tf 来置备此环境。

三十六节点仿真

一个包含 36 个节点的生产仿真环境（simu.yml），涵盖了所有 Pigsty 组件

您可以使用 Vagrant simu.rb 来置备此环境。 您可以在真实服务器（72C / 256G）上运行整个仿真，使用 Vagrant 的 libvirt 作为虚拟机提供程序。

• 2 个基础设施节点，相互监控
• 2 个专用代理节点运行 HAProxy
• 5 节点 ETCD 集群可容忍 2 个节点故障，以及 5 节点 Redis Sentinel 集群
• 5 节点 MinIO 集群，每个节点有 4 个磁盘
• 10 个 PostgreSQL 集群：pg13 - pg15、pg-src、pg-dst、pg-pitr、pg-test
• 10 节点 Citus 集群有 5 个分片
• Redis 独立集群 redis-src 和 redis-dst，以及原生集群 redis-test

1.4 - 离线安装

Pigsty 默认从互联网上游 安装 所需软件包，但有些环境与互联网隔离。 为了解决这个问题，Pigsty 支持使用 离线软件包 进行离线安装。

    下载 pigsty 离线软件包，将其放到 `/tmp/pkg.tgz`

    下载 pigsty 源码包，解压（假设解压到 `~/pigsty`）

    `cd ~/pigsty; ./bootstrap`，它将解压软件包并使用本地仓库

    `vi ~/pigsty.yml`，覆盖 [`node_repo_modules`](/zh/docs/node/param#node_repo_modules) 设为 `local` 以使用本地仓库

    照常运行 `./install.yml`。它将从本地仓库安装所有内容。

什么是离线软件包？

离线软件包打包了所有需要的 RPM/DEB 软件包及其依赖； 它本质上是在正常 安装 后采取的本地 APT / YUM 仓库的快照压缩包。

您可以从 GitHub 发布页面 找到这些软件包，例如：

d6e9d6fa73620460ceb373a0c2f41ebe  pigsty-v3.7.0.tgz
987529769d85a3a01776caefefa93ecb  pigsty-pkg-v3.7.0.d12.aarch64.tgz
2d8272493784ae35abeac84568950623  pigsty-pkg-v3.7.0.d12.x86_64.tgz
090cc2531dcc25db3302f35cb3076dfa  pigsty-pkg-v3.7.0.d13.x86_64.tgz
ddc54a9c4a585da323c60736b8560f55  pigsty-pkg-v3.7.0.el10.aarch64.tgz
d376e75c490e8f326ea0f0fbb4a8fd9b  pigsty-pkg-v3.7.0.el10.x86_64.tgz
8c2deeba1e1d09ef3d46d77a99494e71  pigsty-pkg-v3.7.0.el8.aarch64.tgz
9795e059bd884b9d1b2208011abe43cd  pigsty-pkg-v3.7.0.el8.x86_64.tgz
08b860155d6764ae817ed25f2fcf9e5b  pigsty-pkg-v3.7.0.el9.aarch64.tgz
1ac430768e488a449d350ce245975baa  pigsty-pkg-v3.7.0.el9.x86_64.tgz
e033aaf23690755848db255904ab3bcd  pigsty-pkg-v3.7.0.u22.aarch64.tgz
cc022ea89181d89d271a9aaabca04165  pigsty-pkg-v3.7.0.u22.x86_64.tgz
0e978598796db3ce96caebd76c76e960  pigsty-pkg-v3.7.0.u24.aarch64.tgz
48223898ace8812cc4ea79cf3178476a  pigsty-pkg-v3.7.0.u24.x86_64.tgz

我们通常为以下 Linux 发行版 发布离线软件包，使用最新的操作系统次要版本。

https://github.com/pgsty/pigsty/releases/download/v3.7.0/pigsty-pkg-v3.7.0.el9.x86_64.tgz

使用离线软件包？

将离线软件包放置于 /tmp/pkg.tgz 路径下，进入 ~/pigsty 目录执行 ./bootstrap，即可解包使用离线安装包。 Pigsty 会将其解压至 /www/pigsty，然后配置系统仓库列表启用此仓库，并从中安装 ansible。

自从 Pigsty v3.6 版本起，大部份配置模板都默认不再构建本地软件仓库，而是直接从互联网上游安装软件包。 少部分配置模板如 rich 与 full 依然保留了旧版本的行为 —— 先构建本地仓库再使用。

如果您想要在自己的配置中使用已经解包配置好的离线软件包，请修改以下配置：

• repo_enabled：将此参数打开，设置为 true，则会构建本地软件源（在大部份配置中被显式关闭）
• node_repo_modules：将此参数设置为 local，则环境中所有节点都从本地软件仓库安装
  • 在大部份模板中，此参数现在被显式配置为：node,infra,pgsql，即直接从这些上游软件仓库安装。
  • 将其设置为 local，则会使用本地软件仓库安装所有软件包，速度最快，没有其他仓库的变数干扰。
  • 如果你想同时使用本地软件仓库和上游软件仓库，可以将其设置为 local,node,infra,pgsql

优缺点

如果您使用的是上述列表中给出的操作系统（精确匹配的小版本），那么建议使用离线软件包。 Pigsty 为这些系统提供了开箱即用的预制离线软件包，在 GitHub 上提供免费下载。

如果你使用的操作系统版本不在上述列表中，你可以考虑自制离线安装包，我们也提供针对更多操作系统大小版本的离线安装包预制服务（¥200）

引导程序

bootstrap 脚本将自动检测 /tmp/pkg.tgz 并默认将其解压到 /www/pigsty。 它还将设置操作系统软件包管理器的仓库文件，并安装 ansible 和其他工具。

./bootstrap -k # 或 --keep

制作离线软件包

如果您选择的操作系统不在默认列表中， 您可以使用内置的 cache.yml 剧本制作自己的离线软件包。

    找到一台运行完全相同操作系统版本，且可以访问互联网的节点

    运行标准 [在线安装](/zh/docs/install) （建议使用 `rich` 配置模板：`configure -c rich`）

    `cd ~/pigsty; ./cache.yml`：制作并获取离线软件包到 `~/pigsty/dist/${version}/`

    将离线软件包复制到没有互联网访问的环境中（ftp、scp、usb 等），通过 `bootstrap` 解包使用

我们提供付费服务，提供经过测试的预制 Linux 主版本.次版本制作离线软件包。（¥200）

混合方法

有一种混合方法可以使用离线软件包作为基础，并在线补足不匹配的增量软件包，这种办法可以融合离线安装与在线安装的优点。

例如，假设您使用的是 RockyLinux 9.5，但官方离线软件包是为 RockyLinux 9.6 制作的。 您可以使用 el9 离线软件包，（虽然是针对 9.6 制作的） 然后在执行正式安装前，执行 make repo-build 重新下载 9.5 对应的缺失软件包， Pigsty 将从上游仓库重新下载所需的增量。

1.5 - 精简安装

如果您只想要高可用 PostgreSQL 本身，而不需要监控、基础设施等功能，请考虑精简安装。

没有 INFRA 模块，没有监控，没有 本地仓库，只有 ETCD 和 PGSQL 以及部分 NODE 功能

概述

使用精简安装，您需要：

  使用 `slim.yml` 配置模板（`configure -c slim`）

  运行 `slim.yml` 剧本而不是 `install.yml`

curl https://repo.pigsty.cc/get | bash -s v3.7.0
./configure -c slim
./install.yml

精简安装只安装这些核心组件：

您可以关闭可选组件，只有两个必需组件是 patroni 和 etcd。

软件包直接从互联网上游仓库安装，离线安装 在此处不适用。

配置

精简安装的配置文件示例：conf/slim.yml：

all:
  children:
    infra: { hosts: { 10.10.10.10: { infra_seq: 1 }} ,vars: { repo_enabled: false }}
    etcd:  { hosts: { 10.10.10.10: { etcd_seq: 1  }} ,vars: { etcd_cluster: etcd  }}

    #----------------------------------------------#
    # PostgreSQL Cluster
    #----------------------------------------------#
    pg-meta:
      hosts:
        10.10.10.10: { pg_seq: 1, pg_role: primary }
      vars:
        pg_cluster: pg-meta
        pg_users:
          - { name: dbuser_meta ,password: DBUser.Meta   ,pgbouncer: true ,roles: [dbrole_admin   ] ,comment: pigsty admin user }
          - { name: dbuser_view ,password: DBUser.Viewer ,pgbouncer: true ,roles: [dbrole_readonly] ,comment: read-only viewer  }
        pg_databases:
          - { name: meta, baseline: cmdb.sql ,comment: pigsty meta database ,schemas: [pigsty] ,extensions: [ vector ]}
        pg_hba_rules:
          - { user: dbuser_view , db: all ,addr: infra ,auth: pwd ,title: 'allow grafana dashboard access cmdb from infra nodes' }
        node_crontab: [ '00 01 * * * postgres /pg/bin/pg-backup full' ] # make a full backup every 1am

  vars:
    #----------------------------------------------#
    # INFRA : https://doc.pgsty.com/infra/param
    #----------------------------------------------#
    version: v3.7.0                   # pigsty version string
    admin_ip: 10.10.10.10             # admin node ip address
    region: default                   # upstream mirror region: default,china,europe
    infra_portal:                     # domain names and upstream servers
      home         : { domain: h.pigsty }
      grafana      : { domain: g.pigsty ,endpoint: "${admin_ip}:3000" , websocket: true }
      prometheus   : { domain: p.pigsty ,endpoint: "${admin_ip}:9058" }
      alertmanager : { domain: a.pigsty ,endpoint: "${admin_ip}:9059" }
      blackbox     : { endpoint: "${admin_ip}:9115" }
      loki         : { endpoint: "${admin_ip}:3100" }

    #----------------------------------------------#
    # NODE : https://doc.pgsty.com/node/param
    #----------------------------------------------#
    nodename_overwrite: false           # do not overwrite node hostname on single node mode
    node_repo_modules: node,infra,pgsql # add these repos directly to the singleton node
    node_tune: oltp                     # node tuning specs: oltp,olap,tiny,crit

    #----------------------------------------------#
    # PGSQL : https://doc.pgsty.com/pgsql/param
    #----------------------------------------------#
    pg_version: 17                      # Default PostgreSQL Major Version is 17
    pg_conf: oltp.yml                   # pgsql tuning specs: {oltp,olap,tiny,crit}.yml
    pg_packages: [ pgsql-main, pgsql-common ]   # pg kernel and common utils
    #pg_extensions: [pg17-time ,pg17-gis ,pg17-rag ,pg17-fts ,pg17-feat ,pg17-lang ,pg17-type ,pg17-util ,pg17-func ,pg17-admin ,pg17-stat ,pg17-sec ,pg17-fdw ,pg17-sim ,pg17-etl ,pg17-olap]

    #----------------------------------------------#
    # SLIM: http://localhost:3000/docs/install/minimal
    #----------------------------------------------#
    nginx_enabled: false              # nginx not exists
    dns_enabled: false                # dnsmasq not exists
    prometheus_enabled: false         # prometheus not exists
    grafana_enabled: false            # grafana not exists
    pg_exporter_enabled: false        # disable pg_exporter
    pgbouncer_exporter_enabled: false # disable pgbouncer_exporter
    pgbackrest_exporter_enabled: false # disable pgbackrest_exporter
    pg_vip_enabled: false             # disable pg_vip

安装

使用 slim.yml 剧本而不是 install.yml 剧本：

./slim.yml

1.6 - 视频演示

请参见 Asciinema 终端录像： Vonng

标准安装

Pigsty v3.6.0, RockyLinux 9.6, x86_64, 标准安装, Link

这会使用默认的 meta 单节点配置模板，从互联网直接安装所有所需软件包。

curl -fsSL https://repo.pigsty.io/get | bash -s v3.6.0; cd ~/pigsty;
./configure
./install.yml

完整安装

Pigsty v3.6.0, Ubuntu 24.04.2, x86_64, 完整安装

完整安装使用 rich 模板，在标准安装的基础上，有以下区别于改动：

• 尽可能安装（但不都启用）所有 PostgreSQL 扩展插件
• 构建本地软件仓库，先下载到本地仓库，再让所有节点都从本地软件仓库进行安装
• 1 node minio used as central backup repo
• cluster stub for 3-node pg-test / ferret / redis
• stub for nginx, certs, and website self-hosting config
• detailed comments for database / user / service

./configure -c rich     # use the conf/rich.yml template
./install.yml

curl -fsSL https://repo.pigsty.io/get | bash -s v3.6.0; cd ~/pigsty;
./configure -i rich
vi pigsty.yml   # edit password
./install.yml

make tu tssh
asciinema rec
ssh meta

ls /www/pigsty
cat ~/pigsty/pigsty.yml | grep node_repo_modules
sudo su - postgres
pg list
pb info
pg-backup incr
pb list
psql
SELECT * FROM pg_available_extensions;

Slim Install

Pigsty v3.6.0, Debian 12.11, aarch64, Slim Installation, Link

Postgres HA Cluster with essential modules, (with ETCD, without INFRA).

asciinema rec
ssh meta
curl -fsSL https://repo.pigsty.io/get | bash -s v3.6.0; cd ~/pigsty;
./configure -i slim
./slim.yml
sudo su - postgres
psql

Offline Install

Pigsty v3.6.0, RockyLinux 9.6, aarch64, Slim Installation

# download this offline package and put it to /tmp/pkg.tgz, we just skip downloading here
# curl https://github.com/pgsty/pigsty/releases/download/v3.6.0/pigsty-pkg-v3.6.0.el9.x86_64.tgz -o /tmp/pkg.tgz
scp ~/pigsty/dist/v3.6.0/pigsty-v3.6.0.tgz meta:~/pigsty.tgz

# download source package and extract it to ~/pigsty, we just skip downloading here
# curl https://github.com/pgsty/pigsty/releases/download/v3.6.0/pigsty-v3.6.0.tgz -o ~/pigsty.tgz; tar xzf ~/pigsty.tgz -C ~/
scp ~/pigsty/dist/v3.6.0/pigsty-pkg-v3.6.0.el9.aarch64.tgz meta:/tmp/pkg.tgz

ssh meta
tar -xf pigsty.yml  # extract pigsty source tarball
cd pigsty           # enter pigsty home dir
./bootstrap         # now bootstrap pigsty from local repo
./configure         # generate pigsty.yml
vi pigsty.yml       # use local repo rather than install from the internet upstream repo
#node_repo_modules: local

./install.yml

Supabase

Pigsty v3.6.0, Ubuntu 24.04, x86_64, Install Supabase

curl -fsSL https://repo.pigsty.io/get | bash -s v3.6.0; cd ~/pigsty;
./configure -c supabase
./install.yml
./docker.yml   # install docker & docker-compose
./app.yml      # launch supabase docker app with docker compose

vi pigsty.yml


curl -fsSL https://repo.pigsty.cc/get | bash -s v3.6.0; cd ~/pigsty
./configure -c supabase    # 使用 supabase 配置（请在 pigsty.yml 中更改凭据）
vi pigsty.yml              # 编辑域名、密码、密钥...
./install.yml              # 安装 pigsty
./docker.yml               # 安装 docker compose 组件
./app.yml                  # 使用 docker 启动 supabase 无状态部分


cd /opt/supabase
docker ps

sudo su - postgres
pg list
pb info
pg-backup incr
pb info

psql
\dn
\l
\du
table pg_available_extensions;

\c supabase
\dn
\du

# Now let's setup your domain name and HTTPS certificates

ssh meta            # the temp cloud server for the supabase demo
dig supa.pigsty.cc  # let's use this as example, use your domain name instead, and resolve it to your server IP
cd ~/pigsty/
grep supa.pigsty pigsty.yml -a2 -b2
sed -ie 's/supa.pigsty/supa.pigsty.cc/g' pigsty.yml  # rename old supa.pigsty domain placeholder to your domain name
sed -ie 's/supa.pigsty.cc/supa.pigsty/g' pigsty.yml  # rename old supa.pigsty domain placeholder to your domain name
grep supa.pigsty pigsty.yml -a2 -b2
curl -i https://supa.pigsty.cc

2 - 准备

    节点、规格、磁盘、网络、VIP、域名...

    支持的 Linux 操作系统发行版列表

    区域设置、防火墙、Ansible、Pigsty...

    用户、Sudo、SSH、可访问性...

您可以利用 IaC 工具如 Terraform 和 Vagrant 来帮助您准备环境并完成繁重的工作。

    Ansible 101，pigsty 用户的基础知识

    用于学习和测试的四节点沙盒

    使用 vagrant 置备本地虚拟机

    使用 terraform 置备云服务器

这里有一个检查清单，帮助您为生产环境中的严肃 Pigsty 部署准备环境。

2.1 - 硬件置备

节点

Pigsty 目前运行在具有 Linux 内核和 x86_64 / aarch64 架构的节点上。

“节点” 指的是 SSH 可访问 且提供裸 Linux 操作系统环境的资源。 它可以是物理机、虚拟机或配备 systemd、sudo 和 sshd 的类似操作系统的容器。

部署 pigsty 至少需要 1 个节点， 您可以准备更多并在 一次性 中设置所有内容，或稍后添加它们。 最小节点规格要求是 1C1G，建议至少使用 2C2G。 越高越好，没有上限。参数将根据可用资源自动调优。

规格

您需要多少个节点？这取决于您的资源和需求。

磁盘

Pigsty 将使用 /data 作为默认数据目录，如果您有专用的主数据磁盘，建议将其挂载到那里， 并为额外的磁盘驱动器使用 /data1、/data2、/dataN。

我们建议使用 ext4 或 xfs 作为数据磁盘的文件系统。它们对 PostgreSQL 有最佳性能。

虽然 ext4 有更多的数据恢复工具，但 xfs 对小文件更高效。 如果您运行 MinIO，建议使用 xfs，否则，建议使用 ext4 作为默认选项。

Pigsty 的工作假设是 /data 目录属于 root:root，权限为 755。 管理员可以分配一级目录的所有权和权限。每个应用在其子目录中运行时将使用专用用户。

网络

Pigsty 需要静态网络才能工作，您应该为每个节点明确分配一个固定的 IPv4 地址。

IP 地址将用作节点的唯一标识符，它应该是绑定到用于内部网络通信的主网络接口的主 IP 地址。

执行标准（在线）安装 时需要互联网访问。 但 pigsty 可以通过离线软件包进行 离线安装， 在这种情况下不需要互联网访问。

VIP

Pigsty 支持 NODE 集群（keepalived）和 PGSQL 集群（vip-manager）的可选 L2 VIP。

要使用 L2 VIP 功能，您必须为它们明确分配一个 L2 VIP。 在您自己的硬件上运行时这不是大问题， 但在公有云环境中工作时可能成为问题。

域名

Pigsty 为以下具有 WebUI 的服务使用本地静态域名。 您可以为这些服务分配自定义域名，或使用真实域名。 只需在 infra_portal 中更改它们。

域名是可选的，要使用它们，用户有责任将以下记录添加到您的 /etc/hosts 文件（本地静态解析）， 或将它们添加到您的 DNS 服务器/公共 DNS 供应商。

10.10.10.10 h.pigsty g.pigsty p.pigsty a.pigsty

2.2 - Linux 系统

系统建议

Pigsty 推荐使用以下操作系统：RockyLinux 9.6， Ubuntu 24.04.2，与 Debian 12.11。

EL

Pigsty 支持 EL 8/9/10 兼容系统（RHEL / Rocky / Alma / Anolis / CentOS …… ），推荐使用 RockyLinux 9.6。

Ubuntu

Pigsty v3.7 支持 Ubuntu 24.04 / 22.04，建议使用 24.04.2。

Debian

Pigsty 可运行于 Debian 13 / 12 / 11 上，建议使用 12.11。

2.3 - 软件置备

Linux

Pigsty 运行在 Linux 操作系统上，它支持 14 种主流 Linux 发行版：兼容操作系统列表

我们推荐使用 RockyLinux 9.6、Debian 12.11 或 Ubuntu 24.04.5 作为默认操作系统选项。

我们强烈建议使用全新安装的操作系统环境，并将 en_US 设置为主要语言。

localedef -i en_US -f UTF-8 en_US.UTF-8
localectl set-locale LANG=en_US.UTF-8

Pigsty 不使用容器，主要组件针对特定发行版主版本打包。

文件系统

Pigsty 建议使用 ext4 或 xfs 文件系统，两者在 PostgreSQL 用例上都有最好的性能表现。 如果您清楚知道自己在做什么，也可以考虑使用 zfs 这样的文件系统，但切勿使用 nfs 等网络文件系统运行数据库服务。

如果您需要使用到 MinIO，建议使用 xfs 文件系统，这是 MinIO 唯一推荐使用到文件系统。 它在大量小文件的场景中有更好的性能表现，但工具生态（例如数据恢复）略逊于 ext4。

如果您只是运行标准 PostgreSQL 服务，我们建议您默认使用 Linux ext4 文件系统。

防火墙

您的安全策略和防火墙设置应该允许访问所需的端口。

要访问 WebUI 服务，您必须允许 HTTP（80）/ HTTPS（443）访问。

要访问 PostgreSQL 数据库服务，您必须允许 postgres 的 5432 端口。

在典型的公有云 VPS 设置中，端口 22/80/443/5432 通常是开放的。

在典型的生产设置中，端口 22/80/443 从 LAN / 跳板机向 DBA/OPS 开放。 其他端口从内网访问。您必须确保它们在内部开放：使用的端口。

Ansible

Pigsty 使用 Ansible 从管理节点发起对所有被管理节点的控制。

您不需要关心细节，ansible 在 Bootstrap 阶段安装。

sudo apt install -y ansible python3-jmespath

sudo dnf install -y ansible python3-jmespath

sudo dnf install -y ansible python3.12-jmespath

sudo yum install -y ansible python-jmespath

brew install ansible
pip3 install jmespath

Ansible 只在管理节点上需要，您可以在 macOS 上运行 ansible 将您的笔记本电脑用作管理节点。

Pigsty

（推荐）您可以使用以下方式获取并提取最新稳定版本的 pigsty 源代码：

curl -fsSL https://repo.pigsty.io/get | bash -s v3.7.0; cd ~/pigsty

curl -fsSL https://repo.pigsty.cc/get | bash -s v3.7.0; cd ~/pigsty   # 中国镜像

要安装特定版本，将版本字符串作为第一个参数传递：

curl -fsSL https://repo.pigsty.io/get | bash -s v3.7.0; cd ~/pigsty

curl -fsSL https://repo.pigsty.cc/get | bash -s v3.7.0; cd ~/pigsty # 中国镜像

您也可以使用 git 从 GitHub 克隆 Pigsty 源代码仓库：

git clone https://github.com/pgsty/pigsty.git; cd ~/pigsty; git checkout v3.7.0

$ curl -fssL https://repo.pigsty.cc/get | bash -s v3.7.0
[v3.7.0] ===========================================
$ curl -fsSL https://repo.pigsty.cc/get | bash -s v3.7.0
[Docs] https://doc.pgsty.com
[Demo] https://g.pgsty.com
[Repo] https://github.com/pgsty/pigsty
[Download] ===========================================
[ OK ] version = v3.7.0 (from arg)
curl -fSL https://repo.pigsty.cc/src/pigsty-v3.7.0.tgz -o /tmp/pigsty-v3.7.0.tgz
[WARN] tarball = /tmp/pigsty-v3.7.0.tgz exists, size = 1472486, use it
[ OK ] md5sums = df64ac0c2b5aab39dd29698a640daf2e  /tmp/pigsty-v3.7.0.tgz
[Install] ===========================================
[ OK ] install = /home/vagrant/pigsty, from /tmp/pigsty-v3.7.0.tgz
[Bootstrap] ===========================================
[ OK ] ansible = ready
[ OK ] bootstrap = skip
you can run ./bootstrap to extrac offline package and install ansible
[TodoList] ===========================================
cd /home/vagrant/pigsty
./configure      # [可选] 预检和配置生成
./install.yml    # 部署配置描述的所有内容

您也可以从 GitHub Release Page 手动下载 pigsty 源代码（pigsty-<version>.tar.gz）：

wget https://repo.pigsty.io/src/pigsty-v3.7.0.tgz

wget https://pigsty.cc/pgsty/pigsty/releases/download/v3.7.0/pigsty-v3.7.0.tgz

wget https://github.com/pgsty/pigsty/releases/download/v3.7.0/pigsty-v3.7.0.tgz

如果您的环境没有互联网访问，请考虑与源代码压缩包一起下载离线软件包并将其上传到您的节点。

详情请查看 离线安装。

2.4 - 管理用户

用户

Pigsty 需要一个在所有被管理节点上具有免密 ssh 和 sudo 权限的操作系统用户。

命名约定

通常我们会选择 dba 或 admin 这样的名称， 但避免使用 root 或 postgres：

提供密码

如果您可以接受每个 ssh 和 sudo 命令的密码提示，则免密要求是可选的。

./install.yml -k -K

创建管理员用户

在服务器置备阶段，用户/供应商有责任创建并交付这样的管理员用户。 但如果您没有这样的管理员用户，或者该用户受到限制，您可以使用 pigsty 本身创建一个：

./node.yml -k -K -t node_admin -e ansible_user=[existing_admin_user]

Sudo 权限

所有 管理员用户 都应该在所有被管理节点上具有免密 sudo 权限。

如果您想从头开始配置具有免密 sudo 权限的管理员用户：

echo '%vagrant ALL=(ALL) NOPASSWD: ALL' | sudo tee /etc/sudoers.d/vagrant

%dba ALL=(ALL) NOPASSWD: ALL

Ansible 依赖 sudo 在被管理节点上以 root 权限执行命令。 因此，在 sudo 不可用的环境中（比如在精简容器内），您可能需要先安装 sudo。

SSH

您的当前用户应该能够以相应的管理员用户身份免密 SSH 访问所有被管理节点。

您的当前用户可以是管理员用户本身，但不是必需的，只要您能以管理员用户身份 SSH。

SSH 配置是 Linux 101，但我们会在此处介绍基础知识，以防您不熟悉：

生成 SSH 密钥

如果您没有 SSH 密钥对，请生成一个

ssh-keygen -t rsa -b 2048 -N '' -f ~/.ssh/id_rsa -q

复制 SSH 密钥

您需要将生成的公钥分发到远程（和本地）服务器，并将其放入 所有节点上管理员用户的 ~/.ssh/authorized_keys 文件中。 可以使用 ssh-copy-id 工具。

ssh-copy-id <ip>                        # 交互式密码输入

sshpass -p <password> ssh-copy-id <ip>  # 非交互式（谨慎使用）

使用别名

当无法直接 SSH 访问时（由于跳板机、其他端口、凭据等…），考虑：

Host meta
    HostName 10.10.10.10
    User dba                      # <--- 远程上不同的用户
    IdentityFile /etc/dba/id_rsa  # <--- 不是普通密钥
    Port 24                       # <--- 不是众所周知的端口

nodes:
  hosts:          # 如果节点 `10.10.10.10` 需要 SSH 别名 `meta`
    10.10.10.10: { ansible_host: meta }  # <---- 通过 `ssh meta` 访问

检查可访问性

您应该能够从管理节点通过当前用户免密 ssh 访问所有被管理节点。 远程用户（管理员用户）应该有权限运行免密 sudo 命令。

ssh <ip|alias> 'sudo ls'

2.5 - 沙箱环境

Pigsty 有一个沙盒，这是一个具有固定 IP 地址和其他标识符的 4 节点部署。

我们将使用它作为学习和测试目的的标准演示环境。

描述

沙盒由具有固定 IP 地址和身份的 4 个节点组成：

在 meta 节点上有一个主要的单例 PostgreSQL 集群：pg-meta， 它可以独立使用，还有一个可选的 L2 VIP 10.10.10.2 和集群 DNS pg-meta 绑定到它。

10.10.10.10 meta pg-meta-1
10.10.10.2  pg-meta

沙盒中还有三个额外的节点，组成一个 3 实例的 PostgreSQL HA 集群 pg-test。 有一个可选的 L2 VIP 10.10.10.3 和集群 DNS pg-test 绑定到集群领导者。

10.10.10.11 node-1 pg-test-1
10.10.10.12 node-2 pg-test-2
10.10.10.13 node-3 pg-test-3
10.10.10.3  pg-test

在 meta 节点上还有一个 1 节点的 etcd 集群和 1 节点的 minio 集群。

10.10.10.10 minio-1
10.10.10.10 etcd-1

实现

您可以使用 Vagrant 创建本地沙盒，或使用 Terraform 创建云沙盒。

要使用本地 vagrant 模板：

make full9     # 使用 RockyLinux 9 创建 4 节点沙盒
make full12     # 使用 Debian 12 创建 4 节点沙盒
make full24     # 使用 Ubuntu 24.04 创建 4 节点沙盒

要使用云 terraform 模板，请使用 spec/aliyun-full.tf 作为示例， 阿里云 4 节点沙盒模板适用于所有发行版和 amd/arm。

make tu     # terraform up
make td     # terraform destroy
make tssh   # 将 ssh 别名写入 ~/.ssh/pigsty_config

2.6 - Vagrant

Pigsty 需要 Linux 环境，您可以使用 Vagrant 轻松创建本地 linux 虚拟机。

您还需要一个虚拟机提供商，（比如笔记本电脑的 VirtualBox 和服务器的 libvirt）

入门

您可以在 macOS 上使用 homebrew 安装 vagrant、virtualbox、ansible：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install vagrant virtualbox ansible

您已准备就绪！使用 make 快捷方式创建虚拟机：

make meta       # 1 节点开发箱，用于快速启动、开发、测试和实验
make full       # 4 节点沙盒，用于 HA 测试和功能演示
make simu       # 36 节点模拟箱，用于生产环境模拟
...
make meta9      # 使用 bento/rockylinux-9 镜像创建单例元节点
make full22     # 使用 generic/ubuntu2204 镜像创建 4 节点沙盒
make simu12     # 使用 generic/debian12 镜像创建 36 节点模拟环境

配置

您必须在启动前在 Vagrantfile 中定义虚拟机。 默认的 Vagrantfile 定义了一个 el9（bento/rockylinux-9）1 节点虚拟机，使用本地 virtualbox VM 提供商。

• vagrant/
  • spec/
    • meta.rb
    • full.rb
    • simu.rb
    • ......
  • Vagrantfile

我们在 vagrant/spec 文件夹中有一系列预定义的 VM 规格

每个规格文件包含一个描述 VM 节点的 Specs 变量。例如，full.rb 包含：

# full: pigsty 全功能 4 节点沙盒，用于 HA 测试、教程和实践

Specs = [
  { "name" => "meta"   , "ip" => "10.10.10.10" ,  "cpu" => "2" ,  "mem" => "4096" ,  "image" => "bento/rockylinux-9"  },
  { "name" => "node-1" , "ip" => "10.10.10.11" ,  "cpu" => "1" ,  "mem" => "2048" ,  "image" => "bento/rockylinux-9"  },
  { "name" => "node-2" , "ip" => "10.10.10.12" ,  "cpu" => "1" ,  "mem" => "2048" ,  "image" => "bento/rockylinux-9"  },
  { "name" => "node-3" , "ip" => "10.10.10.13" ,  "cpu" => "1" ,  "mem" => "2048" ,  "image" => "bento/rockylinux-9"  },
]

您可以使用规格与 config 脚本，它将根据规格和环境变量（资源、镜像、vm 提供商等…）渲染 Vagrantfile。

cd ~/pigsty
vagrant/config [spec] [image] [scale] [provider]

vagrant/config meta                # 使用 1 节点规格，默认 el8 镜像
vagrant/config dual el9            # 使用 2 节点规格，使用 el9 镜像
vagrant/config trio d12 2          # 使用 3 节点规格，使用 debian12 镜像，双倍 cpu/mem 资源
vagrant/config full u22 4          # 使用 4 节点规格，使用 ubuntu22 镜像，使用 4x cpu/mem 资源
vagrant/config simu u24 1 libvirt  # 使用 36 节点规格，使用 ubuntu24 镜像，使用 libvirt 作为提供商而不是 virtualbox

您可以使用环境变量 VM_SCALE 扩展资源单位，默认值为 1。

例如，VM_SCALE=2 vagrant/config meta 将使 meta 规格的 cpu / mem 资源翻倍

Specs = [
  { "name" => "meta" , "ip" => "10.10.10.10", "cpu" => "8" , "mem" => "16384" , "image" => "bento/rockylinux-9" },
]

快捷方式

配置后，您可以使用 vagrant up 命令创建虚拟机。

Pigsty 模板将使用您的 ~/.ssh/id_rsa[.pub] 作为 vagrant 置备的默认 ssh 密钥。 在开始之前确保您有有效的 ssh 密钥对，您可以通过以下方式生成一个：ssh-keygen -t rsa -b 2048

有一些包装 vagrant 命令的快捷方式，您可以使用它们来管理虚拟机。

make         # = make start
make new     # 销毁现有 vm 并创建新的
make ssh     # 将 VM ssh 配置写入 ~/.ssh/     （必需）
make dns     # 将 VM DNS 记录写入 /etc/hosts （可选）
make start   # 启动 VM 并写入 ssh 配置    （up + ssh）
make up      # 使用 vagrant up 启动 VM
make halt    # 关闭 VM （down,dw）
make clean   # 销毁 VM （clean/del/destroy）
make status  # 显示 VM 状态 （st）
make pause   # 暂停 VM （suspend,pause）
make resume  # 恢复 VM （resume）
make nuke    # 使用 virsh 销毁所有 vm 和卷（如果使用 libvirt）

版本

Pigsty 目前使用以下 vagrant 盒子进行测试：

$ vagrant box list

el8 :  bento/rockylinux-8     (libvirt, 202502.21.0, (amd64))
el9 :  bento/rockylinux-9     (libvirt, 202502.21.0, (amd64))

d11 :  generic/debian11       (libvirt, 4.3.12, (amd64))
d12 :  generic/debian12       (libvirt, 4.3.12, (amd64))

u20 :  generic/ubuntu2004     (libvirt, 4.3.12, (amd64))
u22 :  generic/ubuntu2204     (libvirt, 4.3.12, (amd64))
u24 :  bento/ubuntu-24.04     (libvirt, 20250316.0.0, (amd64))

它们并非都有 arm64 架构支持，所以在使用 Apple Silicon MacOS 时要注意。

bento/rockylinux-9 (virtualbox, 202502.21.0, (arm64))
bento/ubuntu-24.04 (virtualbox, 202502.21.0, (arm64))

您可以在 https://app.vagrantup.com/bento/boxes 上找到支持的 Box 镜像

注意事项

echo "10.0.0.0/8" | sudo tee -a /etc/vbox/networks.conf

2.7 - Terraform

Terraform 是一个流行的 IaC 工具。您可以使用一个命令在公有云上创建虚拟机。

阿里云和 AWS 模板用作示例提供商。您可以将 terraform.tf 作为示例。

入门

您可以在 macOS 上使用 homebrew 安装 terraform

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install terraform

然后初始化 terraform 云提供商，调整 terraform.tf 配置文件并应用它：

terraform init
terraform apply #-auto-approve

打印公共 IP 地址：

terraform output | grep -Eo '[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}'

AWS 设置

您必须设置 aws 配置和凭据才能使用 AWS 提供商。

# ~/.aws

# ~/.aws/config
[default]
region = cn-northwest-1

# ~/.aws/credentials
[default]
aws_access_key_id = <YOUR_AWS_ACCESS_KEY>
aws_secret_access_key =  <AWS_ACCESS_SECRET>

# ~/.aws/pigsty-key
# ~/.aws/pigsty-key.pub

有一个 AWS（Amazon Web Services）的贡献示例，但它没有得到积极维护。

• spec/aws-cn.tf : AWS 4 节点 CentOS7 环境

阿里云设置

您可以将您的阿里云凭据添加到环境文件中，例如 ~/.bash_profile

export ALICLOUD_ACCESS_KEY="<your_access_key>"
export ALICLOUD_SECRET_KEY="<your_secret_key>"
export ALICLOUD_REGION="cn-beijing"

示例配置文件：

• spec/aliyun-meta.tf : 阿里云 1 元节点模板，适用于所有发行版和 amd/arm（默认）
• spec/aliyun-full.tf : 阿里云 4 节点沙盒模板，适用于所有发行版和 amd/arm。
• spec/aliyun-oss.tf : 阿里云 5 节点构建模板，适用于所有发行版和 amd/arm。

以下是阿里云中使用的示例 ECS 公共操作系统镜像：

腾讯云设置

有一个腾讯云的贡献示例，但它没有得到积极维护。

• spec/tencentcloud.tf : 腾讯云 4 节点 CentOS7 环境

3 - 配置

Pigsty 将基础设施和数据库视为代码。 您可以使用声明式配置 清单 描述一切。 通常是 YAML 格式的 Ansible 清单：pigsty.yml。 但 CMDB 也可以用作动态清单。

configure 过程将根据您的环境和输入生成配置。 但这是 可选的：您始终可以直接编辑 pigsty.yml 文件，如 教程 所示。 并且有大量的 模板 供您参考。

    Pigsty 的主配置文件，描述您的整个部署

    根据您的输入和环境生成配置文件

    根据业务需求规划您的部署

    可用的配置模板和示例

    生产部署的安全考虑和最佳实践

    使用 PostgreSQL 作为 CMDB 而不是本地 YAML 配置文件

    具有 HA、PITR、IaC、ACL、监控、连接池的 PostgreSQL 集群

    用于可观测性的 Nginx、仓库、DNS、NTP、Prometheus 和 Grafana 技术栈

    将节点注册到期望状态并监控它，以及 VIP、HAProxy

    可靠的分布式共识存储 (DCS)，为 PGSQL HA 提供支持

    兼容 S3 的对象存储，可选备份存储

    高性能内存缓存，可选数据结构服务器

3.1 - 清单

每个 pigsty 部署都有一个对应的配置 清单。 它可以存储在 YAML 格式的本地配置文件中，或从 CMDB 或任何 ansible 兼容格式动态生成。 Pigsty 默认使用一个单一的 YAML 配置文件，即 pigsty.yml，位于 pigsty 主目录中。

• pigsty/
  • pigsty.yml
  • ansible.cfg

configure 脚本将根据您的环境和输入生成具有良好默认值的 pigsty.yml 文件脚手架， 但它是 可选的：您始终可以直接编辑 pigsty.yml 文件，如教程所示。

结构

清单由两部分组成：全局变量 和多个 组。您可以在 all.children 中定义新集群。 并使用全局变量描述基础设施：all.vars。它可能看起来像这样：

all:                  # 顶级对象：all
  vars: {...}         # 全局参数
  children:           # 组定义
    infra:            # 组定义：'infra'
      hosts: {...}        # 组成员：'infra'
      vars:  {...}        # 组参数：'infra'
    etcd:    {...}    # 组定义：'etcd'
    pg-meta: {...}    # 组定义：'pg-meta'
    pg-test: {...}    # 组定义：'pg-test'
    redis-test: {...} # 组定义：'redis-test'
    # ...

在 conf/ 下有大量示例，在 configure 期间也可以用作模板。

集群

每个 ansible 组可能代表一个集群，可以是节点集群、PostgreSQL 集群、Redis 集群、Etcd 集群或 Minio 集群等…

集群定义由两部分组成：hosts 和 vars。 您可以在 <cls>.hosts 中定义集群成员，并在 <cls>.vars 中使用参数描述集群。 这是一个 3 节点 HA PG 集群的示例：

all:
  children:    # 所有组
    pg-test:   # 组名
      hosts:   # 组主机（集群成员）
        10.10.10.11: { pg_seq: 1, pg_role: primary } # 主机 1
        10.10.10.12: { pg_seq: 2, pg_role: replica } # 主机 2
        10.10.10.13: { pg_seq: 3, pg_role: offline } # 主机 3
      vars:    # 组变量（集群参数）
        pg_cluster: pg-test