清单

每个 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

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

参数

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

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

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

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

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

可用参数根据模块而异：

参考

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