这是本节的多页打印视图。 点击此处打印.

返回本页常规视图.

演示模板

用于演示和展示的配置模板

用于演示和展示的配置模板。

模板说明
demoPigsty 公开演示站点配置
minio四节点多盘高可用 MinIO 集群

1 - demo

Pigsty 公开演示站点配置，展示如何配置 SSL 证书、暴露域名、安装全部扩展

demo 配置模板是 Pigsty 公开演示站点使用的配置文件，展示了如何对外暴露网站、配置 SSL 证书、安装全部扩展插件。

如果您希望在云服务器上搭建自己的公开服务，可以参考此配置模板。

配置概览

  • 配置名称： demo（位于 demo/demo.yml）
  • 节点数量： 单节点
  • 配置说明：Pigsty 公开演示站点配置
  • 适用系统：el8, el9, d12, u22, u24
  • 适用架构：x86_64
  • 相关配置：meta，rich

启用方式：

./configure -c demo/demo [-i <primary_ip>]

主要特性

此模板在 meta 基础上进行了以下增强：

  • 配置 SSL 证书和自定义域名（如 pigsty.cc）
  • 下载并安装 PostgreSQL 18 所有可用扩展
  • 启用 Docker 并配置镜像加速
  • 部署 MinIO 对象存储
  • 预置多个业务数据库和用户
  • 添加 Redis 主从实例示例
  • 添加 FerretDB MongoDB 兼容集群
  • 添加 Kafka 样例集群

配置内容

源文件地址：pigsty/conf/demo/demo.yml

all:
  children:

    infra:
      hosts: { 10.10.10.10: { infra_seq: 1 } }
      vars:
        nodename: pigsty.cc
        node_id_from_pg: false
        docker_enabled: true
        docker_registry_mirrors: ["https://mirror.ccs.tencentyun.com"]

    etcd: { hosts: { 10.10.10.10: { etcd_seq: 1 } }, vars: { etcd_cluster: etcd } }
    minio: { hosts: { 10.10.10.10: { minio_seq: 1 } }, vars: { minio_cluster: minio } }

    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 }
          - {name: dbuser_view     ,password: DBUser.Viewer   ,pgbouncer: true ,roles: [dbrole_readonly] ,comment: read-only viewer }
          - {name: dbuser_grafana  ,password: DBUser.Grafana  ,pgbouncer: true ,roles: [dbrole_admin]    ,comment: grafana user }
          - {name: dbuser_odoo     ,password: DBUser.Odoo     ,pgbouncer: true ,roles: [dbrole_admin]    ,createdb: true }
        pg_databases:
          - {name: meta ,baseline: cmdb.sql ,schemas: [pigsty] ,extensions: [{name: vector},{name: postgis},{name: timescaledb}]}
          - {name: grafana  ,owner: dbuser_grafana  ,revokeconn: true }
          - {name: odoo     ,owner: dbuser_odoo     ,revokeconn: true }
        pg_libs: 'timescaledb, pg_stat_statements, auto_explain'
        pg_extensions:
          - timescaledb periods temporal_tables emaj table_version pg_cron pg_later pg_background
          - postgis pgrouting pointcloud q3c geoip pg_polyline pg_geohash
          - pgvector pgvectorscale pg_vectorize pg_similarity smlar pg_summarize pg_tiktoken pg4ml
          - pg_search pg_bigm zhparser hunspell
          - pg_analytics pg_duckdb duckdb_fdw pg_parquet pg_fkpart plproxy
          # ... 更多扩展

    redis-ms:
      hosts: { 10.10.10.10: { redis_node: 1 , redis_instances: { 6379: { }, 6380: { replica_of: '10.10.10.10 6379' } } } }
      vars: { redis_cluster: redis-ms ,redis_password: 'redis.ms' ,redis_max_memory: 64MB }

    pg-mongo:
      hosts: { 10.10.10.10: { mongo_seq: 1 } }
      vars:
        mongo_cluster: pg-mongo
        mongo_pgurl: 'postgres://dbuser_meta:DBUser.Meta@10.10.10.10:5432/grafana'


  vars:
    version: v4.0.0
    admin_ip: 10.10.10.10
    region: china

    # SSL 证书和域名配置
    infra_portal:
      home         : { domain: home.pigsty.cc }
      cc           : { domain: pigsty.cc      ,path: "/www/pigsty.cc" ,cert: /etc/cert/pigsty.cc.crt ,key: /etc/cert/pigsty.cc.key }
      grafana      : { domain: demo.pigsty.cc ,endpoint: "${admin_ip}:3000" ,websocket: true ,cert: /etc/cert/demo.pigsty.cc.crt ,key: /etc/cert/demo.pigsty.cc.key }
      prometheus   : { domain: p.pigsty.cc    ,endpoint: "${admin_ip}:9090" }
      alertmanager : { domain: a.pigsty.cc    ,endpoint: "${admin_ip}:9093" }
      minio        : { domain: m.pigsty.cc    ,endpoint: "${admin_ip}:9001" ,scheme: https ,websocket: true }
      # ... 更多服务域名

    node_timezone: Asia/Hong_Kong
    node_ntp_servers:
      - pool cn.pool.ntp.org iburst
      - pool ${admin_ip} iburst

    # 下载 Docker 和全部扩展
    repo_modules: infra,node,pgsql,docker
    repo_packages: [ node-bootstrap, infra-package, infra-addons, node-package1, node-package2, pgsql-utility, docker ]
    pg_version: 18
    repo_extra_packages: [pg18-core ,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 ]

配置解读

demo 模板是 Pigsty 的公开演示配置，展示了完整的生产级部署示例。

关键特性：

  • 配置 HTTPS 证书和自定义域名
  • 安装所有可用的 PostgreSQL 扩展
  • 集成 Redis、FerretDB、Kafka 等组件
  • 配置 Docker 镜像加速

适用场景：

  • 搭建公开演示站点
  • 需要完整功能展示的场景
  • 学习 Pigsty 高级配置

注意事项：

  • 需要准备 SSL 证书文件
  • 需要配置 DNS 解析
  • 部分扩展在 ARM64 架构不可用

2 - minio

四节点 x 四盘位的高可用多节点多盘 MinIO 集群演示

minio 配置模板演示了如何部署一套四节点 x 四盘位、总计十六盘的高可用 MinIO 集群，提供 S3 兼容的对象存储服务。

更多教程，请参考 MINIO 模块文档。

配置概览

  • 配置名称： minio（位于 demo/minio.yml）
  • 节点数量： 四节点
  • 配置说明：高可用多节点多盘 MinIO 集群演示
  • 适用系统：el8, el9, d12, u22, u24
  • 适用架构：x86_64, aarch64
  • 相关配置：meta

启用方式：

./configure -c demo/minio

备注：这是一个四节点模版，您需要在生成配置后修改其他三个节点的 IP 地址

配置内容

源文件地址：pigsty/conf/demo/minio.yml

all:
  children:

    # infra cluster for proxy, monitor, alert, etc..
    infra: { hosts: { 10.10.10.10: { infra_seq: 1 } } }

    # minio cluster with 4 nodes and 4 drivers per node
    minio:
      hosts:
        10.10.10.10: { minio_seq: 1 , nodename: minio-1 }
        10.10.10.11: { minio_seq: 2 , nodename: minio-2 }
        10.10.10.12: { minio_seq: 3 , nodename: minio-3 }
        10.10.10.13: { minio_seq: 4 , nodename: minio-4 }
      vars:
        minio_cluster: minio
        minio_data: '/data{1...4}'          # 每节点4盘
        minio_buckets:                      # 创建存储桶
          - { name: pgsql }
          - { name: meta ,versioning: true }
          - { name: data }
        minio_users:                        # 创建用户
          - { 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  }

        # 绑定 L2 VIP (10.10.10.9) 到 minio 集群（可选）
        node_cluster: minio
        vip_enabled: true
        vip_vrid: 128
        vip_address: 10.10.10.9
        vip_interface: eth1

        # 在所有节点上通过 HAProxy 暴露 MinIO 服务
        haproxy_services:
          - name: minio
            port: 9002
            balance: leastconn
            options:
              - option httpchk
              - option http-keep-alive
              - http-check send meth OPTIONS uri /minio/health/live
              - http-check expect status 200
            servers:
              - { name: minio-1 ,ip: 10.10.10.10 ,port: 9000 ,options: 'check-ssl ca-file /etc/pki/ca.crt check port 9000' }
              - { name: minio-2 ,ip: 10.10.10.11 ,port: 9000 ,options: 'check-ssl ca-file /etc/pki/ca.crt check port 9000' }
              - { name: minio-3 ,ip: 10.10.10.12 ,port: 9000 ,options: 'check-ssl ca-file /etc/pki/ca.crt check port 9000' }
              - { name: minio-4 ,ip: 10.10.10.13 ,port: 9000 ,options: 'check-ssl ca-file /etc/pki/ca.crt check port 9000' }

  vars:
    version: v4.0.0
    admin_ip: 10.10.10.10
    region: default
    infra_portal:
      home : { domain: i.pigsty }
      # 每个 MinIO 节点的控制台访问域名
      minio   : { domain: m.pigsty   ,endpoint: "10.10.10.10:9001" ,scheme: https ,websocket: true }
      minio10 : { domain: m10.pigsty ,endpoint: "10.10.10.10:9001" ,scheme: https ,websocket: true }
      minio11 : { domain: m11.pigsty ,endpoint: "10.10.10.11:9001" ,scheme: https ,websocket: true }
      minio12 : { domain: m12.pigsty ,endpoint: "10.10.10.12:9001" ,scheme: https ,websocket: true }
      minio13 : { domain: m13.pigsty ,endpoint: "10.10.10.13:9001" ,scheme: https ,websocket: true }

    minio_endpoint: https://sss.pigsty:9002   # 使用 HAProxy 负载均衡端点
    node_etc_hosts: ["10.10.10.9 sss.pigsty"] # VIP 域名解析

    #----------------------------------------------#
    # PASSWORD
    #----------------------------------------------#
    grafana_admin_password: pigsty
    haproxy_admin_password: pigsty
    minio_secret_key: S3User.MinIO

配置解读

minio 模板是 MinIO 生产级部署的参考配置，展示了多节点多盘 (MNMD) 架构。

关键特性：

  • 多节点多盘架构：4 节点 × 4 盘 = 16 盘纠删码组
  • L2 VIP 高可用：通过 Keepalived 绑定虚拟 IP
  • HAProxy 负载均衡：9002 端口统一访问入口
  • 细粒度权限：为不同应用创建独立用户和存储桶

访问方式：

# 使用 mcli 配置 MinIO 别名（通过 HAProxy 负载均衡）
mcli alias set sss https://sss.pigsty:9002 minioadmin S3User.MinIO

# 列出存储桶
mcli ls sss/

# 使用控制台
# 访问 https://m.pigsty 或 https://m10-m13.pigsty

适用场景：

  • 需要 S3 兼容对象存储的环境
  • PostgreSQL 备份存储（pgBackRest 远程仓库）
  • 大数据和 AI 工作负载的数据湖
  • 需要高可用对象存储的生产环境

注意事项：

  • 每个节点需要准备 4 块独立磁盘挂载到 /data1 - /data4
  • 生产环境建议至少 4 节点以实现纠删码冗余
  • VIP 需要正确配置网络接口（vip_interface）
  • 节点间需要能够互相解析 minio-{1...4}.pigsty 域名