清单

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

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

集群级别的 vars 将覆盖全局变量，主机级别的 vars 将覆盖集群变量和全局变量。

参数

参数是定义部署中所有实体的键值对。 键是字符串名称，值可以是五种类型之一：布尔值、字符串、数字、数组或对象。

参数可以在不同级别设置，具有以下优先级：

以下是关于参数优先级的一些示例：

• 使用 Playbook CLI 参数 -e pg_clean=true 强制删除现有数据库
• 使用主机变量上的实例级别参数 pg_role 覆盖 pg 实例角色
• 使用组变量上的集群级别参数 pg_cluster 覆盖 pg 集群名称。
• 使用全局变量上的全局参数 node_ntp_servers 指定全局 NTP 服务器
• 如果没有设置 pg_version，pigsty 将使用角色实现的默认值（默认为 17）

除了强制性的 身份参数 外，每个参数都有一个适当的默认值；它们用作标识符，必须明确设置。 例如上述片段中的 pg_cluster、pg_role 和 pg_seq。

可用参数根据模块而异：

参考

Pigsty 有 290+ 个参数，查看模块参数了解详细信息。