01 / INFRASTRUCTURE AS CODE
声明式交付
◇ 用清单描述目标状态，用剧本完成可重复收敛
- 从单机沙箱平滑扩展到多节点生产环境
- 配置、身份、服务与访问策略均可审阅
- 变更路径与日常管理手册保持一致
让数据库基础设施成为可版本化、可复现的工程资产。
pigsty.yml
# declare the desired state
$ ./configure -c rich
$ ./deploy.yml
✓ PostgreSQL service ready
文档范围
一套面向 Pigsty 本身的工程知识库
4核心模块
7可选模块
575已打包 PG 扩展
0.6.0OINK 固定版本
核心能力
从主机到数据库服务的完整交付路径
文档按真实运维路径组织，既解释系统设计，也提供可以直接执行的配置、剧本与操作手册。
02 / HIGH AVAILABILITY
高可用与时间点恢复
◇ 把故障切换、备份归档和恢复演练放进同一套体系
- PostgreSQL 集群自动故障检测与主从切换
- 本地或 S3 兼容仓库的连续 WAL 归档
- 面向节点、集群与时间点的恢复流程
不只描述组件，还明确失效模式、RTO、RPO 与操作边界。
03 / OBSERVABILITY
开箱即用的可观测性
◇ 指标、日志、告警和管理界面围绕同一套资源模型组织
- PostgreSQL、主机、中间件与应用的统一监控
- VictoriaMetrics、VictoriaLogs 与 Grafana 集成
- 从总览到实例、查询和对象级别的下钻路径
让部署后的系统从第一分钟起就是可解释、可诊断的。
模块手册
按能力组合你的数据基础设施
核心 PINE 模块提供 PostgreSQL RDS 基座，可选模块按需补充存储、缓存、消息、数据库与开发环境。
PGSQL
PostgreSQL 高可用集群与完整生命周期管理。
INFRA
可观测性、门户与基础设施服务。
NODE
主机纳管、日志、网络与负载均衡。
ETCD
为高可用提供分布式配置存储。
MINIO / Silo
S3 兼容对象存储与备份仓库。
REDIS / Valkey
主从、Sentinel 与原生集群。
JUICE
基于 JuiceFS 的共享 POSIX 存储。
KAFKA
动态 KRaft、安全与可观测性。
MYSQL
MySQL 8.4 LTS 与 InnoDB Cluster。
DOCKER
受管容器运行环境。
VIBE
浏览器化开发环境与 AI 编程沙箱。
迁移原则
聚焦、可追溯、可持续演进
只保留关键内容
基础文档和模块手册进入新站，旁支组件文档留在原站。
引用不断裂
被排除内容的必要引用改为旧站链接，而不是留下内部死链。
版本事实分层
v5 文档预览、当前稳定版本与历史发布记录分别表达，不混为一谈。
常见问题
关于这次文档迁移
这是 Pigsty v5.0 的正式发布文档吗？
当前是 v5.0 文档站骨架与内容迁移基线。安装示例仍引用已发布的稳定版本，v5.0.0 发布页以草稿占位，正式发布时再更新事实与内容。
为什么没有 Pig、Patroni、pgBackRest 等独立手册？
新站聚焦 Pigsty 自身的基础文档与模块文档。Pigsty 集成这些组件的配置和运维说明仍在对应模块中；组件自身的独立手册通过链接保留在旧站。
版本发布为什么都使用 x.y.z？
Release 专栏以真实 Git 标签为基础，并统一使用完整语义版本号，避免 4.5、4.5.0 和文章标题混用造成歧义。
从快速上手开始探索 Pigsty v5.0。先理解架构和配置模型，再进入生产部署与模块手册。