运维 SOP 索引

上手路线

任务索引

准备与部署

生产部署先看 架构规划 和 资源准备。这两篇解决节点数量、磁盘、文件系统、网络、VIP、域名、软件源这些问题。

机器准备好以后，看 管理机制：管理用户、免密 SSH、Sudo、可达性、防火墙都在这里。系统版本和架构看 Linux 兼容性。

第一次安装走 快速上手。多节点生产环境走 生产部署。没有互联网访问时，看 离线安装 和 软件仓库管理。

模板选择不用一开始想太复杂：单机默认看 meta；三节点 HA 看 ha/trio；更完整的 HA 看 ha/full；强调一致性看 ha/safe；资源紧张时看 ha/dual 和 ha/simu。

命名与配置

先分清三个名字：集群名、数据库名、服务名。

pg_cluster 是 Pigsty 管理 PostgreSQL 集群的顶层名字，会影响实例名、服务名、备份 stanza、监控标签和很多文件路径。它不是一个可以随手改的显示名。命名规则看 PGSQL 集群模型；不同实例角色看 集群实例配置；服务名和连接入口看 服务/接入。

数据库名和用户名是 PostgreSQL 里的逻辑对象。库名看 数据库配置 和 数据库管理；用户和角色看 用户/角色配置 和 用户管理；权限模型看 访问控制 与 ACL 配置。

经验上，集群名用小写字母、数字、短横线，例如 pg-meta、pg-test、pg-user-prod。数据库对象名用 snake_case，别用中文、空格、大小写混用和 SQL 关键字。更完整的命名背景可以读 数据库集群管理概念与实体命名规范 和 PostgreSQL 规约（2024版）。

配置变更遵循一个习惯：先改 pigsty.yml，再执行对应剧本。配置结构看 声明式配置 和 配置清单；参数含义看 配置参数 与 参数列表；剧本入口看 执行剧本 和 剧本列表。

日常管理

数据库管理的总入口是 PGSQL 日常管理。

PostgreSQL 例行维护的背景文章可以看 PostgreSQL 例行维护。

高可用演练

理解 HA 先看 PG 高可用。不要只看“能不能自动切换”，还要看 RPO 和 RTO：前者是最多能丢多少数据，后者是多久恢复服务。

接入层看 HA 服务接入 和 服务/接入；组件关系看 PGSQL 架构；Etcd 的角色看 ETCD 配置。

演练入口集中在三处：主动切换看 Patroni 管理；服务状态看 组件管理；极端故障看 3坏2应急处理。需要 VIP 时，再看 配置 PG VIP。

背景文章可读 PostgreSQL 高可用到底怎么做？。

备份与恢复

PITR 先读 时间点恢复，再读 工作原理、实现架构、策略权衡 和 典型场景。

配置和维护看 备份恢复、备份策略、备份机制、备份仓库 和 备份管理命令。

真正恢复时，自动方式看 恢复操作，手工演练看 手工恢复。误删数据、表、库，看 误删处理。不想直接动原集群时，先看 克隆数据库集群 或 Fork 实例。

恢复前至少确认四件事：目标时间点或恢复点是否明确；备份和 WAL 是否连续；业务是否已经停写；是在原集群恢复，还是先拉一个新集群验数据。

背景文章可读 备份恢复手段概览 和 PgBackRest2中文文档。

监控与排障

监控总览看 监控系统。入口和域名看 图形界面。数据库指标、日志、告警看 PGSQL 监控 和 PGSQL 仪表盘。

非数据库模块的监控分别看 INFRA 监控、NODE 监控、ETCD 监控 和 MINIO 监控。

排障先看 PGSQL 常见问题，再看 故障排查。连接认证问题看 HBA 管理；HA 状态问题看 Patroni 管理；进程状态问题看 组件管理。

PostgreSQL 通用排障文章：PG 服务器日志常规配置、PostgreSQL 宏观查询优化之 pg_stat_statements、故障档案：PostgreSQL 事务号回卷、查找虚假索引 和 表膨胀治理。

扩缩容、升级、迁移

容量和拓扑设计看 架构规划、资源准备 和 PGSQL 集群模型。

按模块扩缩容时，PGSQL 看 集群管理；NODE 看 NODE 管理；ETCD 看 ETCD 管理；MINIO 看 MINIO 管理；INFRA 看 INFRA 管理预案；REDIS 看 REDIS 管理。

升级 PostgreSQL 看 版本升级 和 内核版本。扩展相关看 扩展插件、扩展管理、扩展仓库 和 软件包别名。

迁移已有 PostgreSQL 看 数据迁移 和 PGSQL 迁移剧本。低停机迁移的思路可以参考 迁移不停机。

需要水平扩展时，再读 Citus 集群部署 和 Citus 内核分支。

安全与入口

部署安全先看 安全考量，安全模型看 安全合规。PostgreSQL 权限看 访问控制 和 ACL 配置；认证规则看 HBA 配置 和 HBA 管理。

证书看 CA 与证书。域名、Nginx、Web 入口看 域名管理 和 Nginx 管理。

生产环境至少要改默认密码，收紧 HBA，明确业务用户和管理用户边界，确认备份仓库的保留、加密和访问权限。

应用接入

应用连接数据库前，先读 服务/接入 和 快速上手 PostgreSQL。连接池行为看 Pgbouncer 管理。

使用 Pigsty 托管数据库、再部署无状态应用时，看 应用模板 和 Docker 模块。

常见误区

延伸阅读