Pigsty v4.5.0

Pigsty v4.5.0 是一个以新试点模块、可替换数据服务、集群身份编排、可观测性和软件供应链为重点的功能版本。 它引入 Kafka KRaft 与 MySQL 8.4 模块，为 REDIS 增加 Valkey 引擎，将 MINIO 模块收敛到 Silo，并把已打包扩展目录从 531 个推进到 575 个。 已提交的完整源码差异见 v4.4.0...61f62e6e。

亮点特性

• 575 个扩展：相比 v4.4.0 的 531 项，当前目录新增 46 项、移除 2 项，净增 44 项；现有 575 个扩展、406 个非 contrib 主软件包族。RPM/DEB 覆盖差异继续按平台记录。
• Kafka KRaft 模块：新增 Pigsty 原生 Kafka 编排，支持多集群、动态成员加入与退役、SCRAM/TLS、安全轮转、监控指标和 Grafana 仪表盘。
• MySQL 8.4 模块：新增单机与三节点 InnoDB Cluster、MySQL Router、XtraBackup、用户与数据库置备、监控告警和幂等协调能力。
• Valkey 与 Silo：REDIS 模块新增 redis_type: valkey；MINIO 模块在最终源码中仅接受 minio_type: silo。本周期曾开发的 RustFS 集成已在候选基线前完整撤回。
• 51 个独立配置模板：在 v4.4.0 的 48 个独立模板基础上新增 demo/kafka、demo/mysql 与八节点 ha/octo 仿真模板；另保留 conf/app/supa.yml → ../supabase.yml 兼容软链接。
• 更安全的集群身份编排：PGSQL、REDIS、MINIO、KAFKA 及 MYSQL 的初始化剧本，以及除 mysql-rm.yml 外的对应移除剧本，都会按显式集群身份跳过无关主机；mysql-rm.yml 则对任何误选主机失败关闭。etcd 委派和 DBSU 密钥交换也改用实际集群成员。
• 可观测性与供应链：Grafana 仪表盘重导出为 Dashboard API v2，MinIO/Silo 改采 Metrics V3；本地仓库由 SOW 原子生成，不再写入伪造的 ModuleMD 元数据。
• 内核与工具链更新：完善 PostgreSQL 19 beta2 的 pgBackRest 支持，启用 Percona PostgreSQL TDE 集群模式，修正 IvorySQL 初始化与 WAL 压缩，并更新 PostgreSQL 扩展包映射、Exporter 与构建工具链。

新模块与数据服务

• Kafka 模块 采用节点状态为权威源的动态 KRaft 编排，可在同一清单中管理一个或多个集群，也可裸跑 kafka.yml；不完整的 --limit 会被拒绝。破坏性的 kafka-rm.yml 则强制要求非空 -l/--limit，并在任何停服前校验安全的绝对数据目录以及部分退役所需的幸存 Broker/Controller 锚点。节点保存权威 manifest/secrets，支持动态控制器加入、Broker 准入、成员退役、故障节点三步替换、SCRAM-SHA-512/TLS、凭据与证书轮换，以及带自测的分区健康门禁。
• MySQL 试点模块 面向固定的 MySQL 8.4 LTS 平台，支持一节点独立实例或三节点 InnoDB Cluster；包括 MySQL Shell/Router、XtraBackup 定时全量备份、TLS、账户与数据库置备、主键策略检查、保守成员移除和幂等协调能力。
• REDIS 模块保留 redis 默认引擎，同时可通过 redis_type: valkey 部署 Valkey；服务单元改用 Type=notify，启动超时扩展到 1800 秒，并加强拓扑校验、密码处理、标签化移除语义和重建保护。
• MINIO 模块现在部署并且只部署 Silo；minio_type 仍作为扩展点保留，但当前唯一合法值是 silo。启动流程通过 systemd Invocation ID 与 ActiveState=active 确认本次重启成功，默认最多等待约 600 秒，再执行 Silo 自带的集群健康检查。Infra 软件包线新增 silo 与 mcli，继续沿用 S3/Admin API、/minio/* 路由、MINIO_* 环境变量和磁盘格式。
• 对象存储拓扑按 minio_cluster 聚合，清单分组名可与集群标识不同，同一清单也可声明多个对象存储集群；每个集群还应使用不同的 minio_alias、minio_domain 与 minio_endpoint，避免在 INFRA 节点覆盖共享客户端别名。demo/minio 已显式选择 Silo，并把本地仓库裁剪为 infra,node 模块。
• 独立 FERRET 模块由 PostgreSQL Mongo 模式 与 FerretDB Docker APP 取代；PostgreSQL 负责 DocumentDB 数据层，Docker Compose 负责 FerretDB 协议层。

编排、安全与工具链

• deploy.yml、slim.yml 以及 PGSQL、REDIS、MINIO、KAFKA、MYSQL 的初始化剧本现在根据对应的 *_cluster 身份跳过无关主机；PGSQL、REDIS、MINIO 与 KAFKA 的移除剧本同样处理。MySQL 移除是有意的例外：mysql-rm.yml 不跳过无身份主机，而是在 mysql_rm_check 失败关闭。所有进入角色的目标仍会执行内部身份校验。
• PGSQL 配置、PITR 与移除流程仅在规范的 etcd 分组存在且至少有一个成员时才委派，不再在缺少 etcd 目标时静默落到本机；DBSU SSH 密钥按实际 pg_cluster_members 交换，可正确覆盖 Citus 等跨清单组拓扑。
• PGSQL 的 PITR 与移除流程现在只删除以 /<cluster>/ 为界的 etcd 子树，避免集群名称互为前缀时误删相邻集群元数据；初始 pgBackRest 备份也只在备份命令成功后写入 /etc/pgbackrest/initial.done。
• HAProxy 采用 /etc/haproxy/haproxy.cfg 与 /etc/haproxy/conf.d 的固定布局，并使用上游 master-worker 模式、master socket 与 Type=notify；dnsmasq 改用动态绑定，同时本地回答私网反向解析，可处理晚于 INFRA 初始化加入的节点地址。
• Pigsty 管理的渲染后 systemd 单元统一放在 /etc/systemd/system，敏感配置和特权文件权限进一步收紧；移除流程会先停服务，再进入数据清理阶段。
• REPO 与 CACHE 角色改用 sow create --pigsty 原子生成 RPM/APT 元数据及 SHA-256 repo_complete 标记，不再生成伪造的 ModuleMD 元数据；pg_id 的集群规模比较也改为显式整数，以兼容较旧 Ansible。
• RPM Exporter 包名由下划线形式统一为连字符形式，例如 node_exporter → node-exporter；同时修复 Debian 仓库名与 PGDG YUM 扩展包名映射。
• 针对不同系统版本选择 tuned 配置目录：EL 10、Debian 13 与 Ubuntu 26 使用 /etc/tuned/profiles，EL 8/9、Debian 12 与 Ubuntu 22/24 继续使用 /etc/tuned；Debian/Ubuntu 安装包时还会阻止 Silo、Redis/Valkey 及遗留日志服务被软件包脚本提前启动。
• 中国区域的软件源路由完成一次系统性刷新：操作系统、Docker、Grafana、Percona、受支持的 MongoDB APT 与 uv/PyPI 路径优先使用腾讯云；EL 与 Docker 条目按平台保留华为云、阿里云回退，MySQL/Kubernetes 使用中科大镜像，ClickHouse 使用华为云。MongoDB RPM 不再声明已经不可用的中国区替代地址；每个平台的最终选择仍以 roles/node_id/vars/<os>.<arch>.yml 为准。
• Docker 镜像更新到 Debian 13.6 并标记 v4.5.0；Vagrant 强制 32GB 根盘并支持固定 box 版本，新增八节点 ha/octo 实验环境。docker/Makefile 的数据目录固定为 ./data，make purge 会直接删除该目录。
• GitHub Actions 的 checkout、CodeQL、Docker build/login 与 Cosign 动作批量升级；发布、引导、安装和校验脚本同步收紧文件与参数处理。发布归档现在从 conf/meta.yml 生成顶层 pigsty.yml，纳入 Kafka/MySQL 剧本并移除旧 Mongo 剧本。
• 发布签名工作流现在要求从 main 分支发起，并且只为 pigsty-<tag>.tgz 源码包生成 Cosign 签名；多 GB 离线包不在该工作流的签名范围内。构建机引导矩阵与 conf/build/oss.yml 对齐为 EL 9/10、Debian 12/13、Ubuntu 22/24/26。

可观测性

• 使用 Pig/Grafana 工具重导出整套仪表盘为 Dashboard API v2；新增 4 个 Kafka 与 5 个 MySQL 仪表盘，并更新节点、PostgreSQL、Redis 与 Infra 仪表盘的链接、变量和布局。
• MinIO/Silo 的 Overview 与 Instance 仪表盘迁移到 Metrics V3；Victoria 抓取统一使用 /minio/metrics/v3 根端点，并丢弃带非空 bucket 标签的高基数样本。
• pg_exporter 配置升级到 1.4.0，并修复 1.4.1 pg_subrel 查询产生重复时间序列的问题；PG19 新增 pg_sub_19、pg_recovery_state、pg_wal_19、pg_lock_stat 与 pg_vacuum_score 采集器，PG10+ 新增 pg_xact_age 事务年龄直方图，同时补齐复制槽 idle_timeout 与 WAL Receiver connecting 状态编码。Kafka JMX/协议 Exporter 与 MySQL Exporter 也纳入统一目标和告警规则。

PostgreSQL 内核与扩展软件包

• PostgreSQL 19 beta3 模板补齐 pgBackRest 软件包与备份支持。

• 四套标准 Patroni 模板为 PostgreSQL 18.6 加入 output_plugin_libraries: 'pgoutput, test_decoding, wal2json' 逻辑解码插件白名单；Patroni 会在不支持该参数的旧 PostgreSQL 版本上过滤它。

• Percona PostgreSQL 18 TDE 模式改为集群模式，继续使用 Pigsty 私有前缀包避免与原生 PostgreSQL 冲突。

• IvorySQL 补齐默认数据库初始化，并在工作负载模板中启用兼容的 WAL 压缩设置。

• PostgreSQL 事实加载器、各平台 package_map 与默认扩展组同步刷新，补齐缺失包并修正 PGDG/YUM 命名。以 v4.4.0 对应的 PIG v1.5.1 目录与当前目录做名称集合比较，共新增 46 项、移除 2 项：

  • 新增 32 个主扩展：argm, cat_tools, cron_utils, fbsql, oidc_validator, online_advisor, pg_cjk_parser, pg_column_tetris, pg_describe, pg_disorder, pg_fts, pg_jieba, pg_kpart, pg_lake, pg_local_cache, pg_mentat, pg_oidc_validator, pg_policy, pg_roast, pg_tiktoken_c, pg_turbovec, pg_vault_tde, pgcontext, pgfr_record, pgmemento, pgmonitor, pgsqlmock, pgwasm, plruby, plx, postbis, qdgc。
  • 随上述软件包新增 13 个子扩展：hstore_plruby, jsonb_plruby, ltree_plruby, pg_extension_base, pg_extension_updater, pg_lake_copy, pg_lake_engine, pg_lake_iceberg, pg_lake_table, pg_map, pgcontext_pgvector, pgfr_analyze, qdgc_postgis。
  • 新增 1 个 PGDG 扩展：pg_statviz；其软件包从默认安装组隐藏，但扩展仍属于在线目录。
  • 移除 2 个目录项：pg_analytics, spat。因此总数从 531 增至 575，净增 44。

• 累计关键升级包括 citus 14.2.0、pg_search 0.25.2、timescaledb 2.29.1、vector 0.8.6、documentdb 0.114、pg_partman 5.5.0、pgmnemo 0.16.1、plpgsql_check 2.10.4、provsql 1.12.0 与 pgbson 2.1.0，并为大量 Rust 扩展切换到 pgrx 0.19.1。

• 扩展包的完整构建记录与平台差异见下方合并表及原始 RPM 变更日志、DEB 变更日志；当前目录页可见 pg_local_cache 与 pg_policy 等新增项。日志日期反映软件包批次，不宜与当前 CSV 的 mtime 逐项等同。

• pg_statviz 在 db/reload.sql 中只被排除出默认安装组；在线目录仍保留其详情、平台覆盖与包名差异。

扩展软件包更新记录

下表合并 v4.4.0 发布后的 RPM 变更日志 与 DEB 变更日志，按“批次 + 扩展名”对齐后共 231 行。RPM 与 DEB 完全相同的记录合并展示；版本或说明不同时分别列出。版本未变化仍表示重构建、包名、许可证元数据或平台覆盖发生变化。

扩展日志在 7 月 10 日后的首个批次为 7 月 24 日；该批次原文覆盖 7 月 7–24 日且没有逐项日期，因此这里完整纳入该批次，以免遗漏发布后的 pgrx 重构建与软件包矩阵修复。“仅 RPM”或“仅 DEB”只表示另一份变更日志中没有同批同名记录。

Infra 软件包更新记录

下表收录 v4.4.0 发布后、从 2026-07-16 到当前最新 2026-08-12 Infra 日志的全部记录，共 144 行；其中也纳入日志正文记录的 ferretdb2 重构建与 RPM Exporter 包名迁移。同一软件包在多个批次连续升级时逐条保留，因此可能出现多次。

表中的构建、下载与核验状态沿用原始日志口径，不代表仓库索引、签名、同步或离线包验收已经完成。完整上下文见 Infra 变更日志。

兼容性变化与升级说明

• 现有 FERRET 部署应移除旧的 ferretdb systemd 服务，并使用 docker.yml 与 app.yml 重新部署协议层；旧的 mongo.yml 剧本、mongo_* 参数、抓取任务和专用仪表盘不再提供。
• HAProxy 单元不再由 Pigsty 渲染 /etc/default/haproxy，但会可选读取该文件。仅使用 EXTRAOPTS 传递进程参数，不再使用 OPTIONS；若覆盖 EXTRAOPTS，必须保留 -S /run/haproxy-master.sock，且不得在其中加入 -f。
• 新版模块剧本要求目标主机显式定义对应的 pg_cluster、redis_cluster、minio_cluster、kafka_cluster 或 mysql_cluster。过去依赖固定组名但缺少集群身份变量的自定义清单需要先补齐身份定义。
• MINIO 角色现在只接受 minio_type: silo；minio 与 rustfs 都会在身份检查阶段失败。Silo 与 MinIO 保持协议及磁盘格式兼容，但软件包、二进制与 systemd 服务名已经变更；升级既有对象存储前仍须完成备份、原地兼容性和回滚验证，不得把软件包替换当作自动迁移已经验收。
• Valkey 仍是显式选择：设置 redis_type: valkey 后安装 valkey-server / valkey-cli，但配置路径、服务名、监控 job 与其他模块接口继续使用 redis，便于兼容现有清单和面板。
• Pigsty 核心 REPO/CACHE 角色要求 SOW，并使用 sow create --pigsty 生成本地仓库；旧离线包或旧本地仓库若不包含 sow 0.3.0，必须先从 Pigsty INFRA 仓库补齐或刷新。pig repo create 属于 CLI 的另一条执行路径，应按其自身版本核对回退行为。
• MySQL 的 mysql_databases 条目只接受 name、encoding 与 collate，数据库固定以 DEFAULT ENCRYPTION='N' 创建；mysql_parameters 不能通过 loose_、skip_、disable_ 或 enable_ 前缀绕过平台保留项与复制/TLS 选项保护。
• 自建 RPM 仓库或外部自动化如果仍引用 node_exporter、redis_exporter 等旧下划线包名，需要迁移到 node-exporter、redis-exporter 等连字符名称。
• docker/Makefile 不再允许用 DATA 把清理目标指向其他路径；make purge 会无倒计时直接删除仓库内的 ./data，执行前应自行确认需要保留的数据。
• KAFKA 与 MYSQL 仍是试点模块；Kafka 客户端必须直连并解析各 Broker，不能把数据平面置于 HAProxy/VIP/L4 负载均衡器之后。MySQL 当前只接受 1 或 3 个成员。

信息来源

• GitHub Release
• Pigsty v4.5 发布文章
• 历史 About / 发布注记
• 源码对比：v4.4.0...v4.5.0