corpusops/postgis

corpusops/setups.postgresql：PostgreSQL自动化部署与配置工具

概述

这是一个基于 corpusops 框架的实用工具，旨在简化PostgreSQL数据库的部署、配置与管理流程。通过标准化的脚本和配置模板，它能帮助用户快速搭建符合生产环境要求的PostgreSQL实例，同时支持灵活的参数调整和版本管理，减少手动操作成本。

核心功能

1. 多版本支持

• 兼容PostgreSQL 10至16等主流版本，可通过配置文件指定目标版本，满足不同项目的兼容性需求。
• 支持同主机部署多实例（需配置不同端口和数据目录），适用于开发测试或隔离环境。

2. 全流程自动化部署

• 集成依赖安装（如编译工具、库文件）、源码编译/包管理安装（可选）、初始化数据库、配置系统服务（systemd）等步骤，无需手动干预。
• 自动生成基础配置文件（postgresql.conf、pg_hba.conf），并支持通过参数模板自定义核心配置（如内存分配、连接数、日志策略）。

3. 配置与服务管理

• 提供简洁的命令行接口，支持启动、停止、重启PostgreSQL服务，以及状态检查、日志查看等日常运维操作。
• 支持动态调整配置参数（无需重启服务的参数可实时生效，需重启的参数会提示操作），并自动备份旧配置文件。

4. 扩展性与兼容性

• 支持常用PostgreSQL插件的集成（如pg_stat_statements、pg_repack），可通过配置文件指定需安装的插件列表。
• 兼容主流Linux发行版（如Ubuntu 20.04+/Debian 11+），依赖corpusops框架的跨平台能力，减少环境适配工作。

环境要求

操作系统

• 支持：Ubuntu 20.04/22.04、Debian 11/12（其他基于Debian的发行版可尝试，需自行测试依赖兼容性）。

依赖工具

• corpusops 框架：需提前安装（建议通过官方脚本或PyPI安装，确保版本≥3.0）。
• 基础依赖：python3（3.6+）、ansible（2.9+）、git、make、gcc（源码编译时需）、libssl-dev、libreadline-dev等（部署时会自动检测并安装缺失依赖）。

硬件建议

• 最低配置：2核CPU、4GB内存、20GB磁盘（适用于开发测试）；
• 生产环境：建议4核以上CPU、8GB+内存、SSD存储（根据数据量调整磁盘大小）。

使用步骤

1. 安装 corpusops 框架

bash
# 通过pip安装（推荐Python 3.8+环境）  
pip install corpusops --upgrade  

# 或从源码安装（如需最新开发版）  
git clone [***]  
cd corpusops.bootstrap  
./bin/bootstrap  # 按提示完成基础环境配置  

2. 获取项目并配置

bash
# 克隆项目源码  
git clone [***]  
cd setups.postgresql  

# 复制示例配置文件并修改（核心参数必配）  
cp examples/setup.postgresql.yml.example setup.postgresql.yml  
vi setup.postgresql.yml  

配置文件关键参数（按实际需求修改）：

yaml
# PostgreSQL版本（如14、15）  
pg_version: "15"  
# 数据存储目录（建议独立分区，如/mnt/pgdata）  
pg_data_dir: "/var/lib/postgresql/{{ pg_version }}/main"  
# 监听端口（默认5432，多实例需改）  
pg_port: 5432  
# 管理员密码（建议强密码，避免明文，可后续通过环境变量传入）  
pg_superuser_password: "YourSecurePassword123"  
# 插件列表（如需安装，如pg_stat_statements）  
pg_extensions: ["pg_stat_statements"]  

3. 执行部署命令

bash
# 检查配置并预执行（可选，用于验证依赖和配置）  
corpusops run --setup postgresql --check  

# 正式部署（会自动处理依赖安装、编译/安装、配置、启动服务）  
corpusops run --setup postgresql  

部署过程中会输出详细日志，若失败可根据日志提示修复（如依赖缺失、权限问题）。

4. 验证部署结果

bash
# 检查服务状态  
systemctl status postgresql@{{ pg_version }}-main  # 服务名格式：postgresql@<版本>-<实例名>  

# 连接数据库验证版本  
psql -U postgres -p {{ pg_port }} -h localhost -c "SELECT version();"  
# 输入配置的pg_superuser_password，若返回版本信息则部署成功  

注意事项

1. 配置文件备份：部署后配置文件会保存在 {{ pg_data_dir }}/postgresql.conf，修改前建议手动备份（工具会自动保留历史版本，路径：{{ pg_data_dir }}/postgresql.conf.old）。

2. 数据备份：生产环境需定期备份数据，可通过 pg_dump 或配置WAL归档（需在配置文件中开启 archive_mode 和 archive_command）。

3. 升级与迁移：如需升级PostgreSQL版本，建议通过工具重新部署新实例，再通过 pg_dumpall 迁移数据（不支持跨版本直接升级，需按PostgreSQL官方迁移流程操作）。

4. 安全性配置：默认配置仅允许本地连接，如需远程访问，需修改 pg_hba.conf 中的IP白名单（如添加 host all all 192.168.1.0/24 md5），并开放防火墙端口（如 ufw allow 5432/tcp）。

5. 日志与监控：日志默认存放在 {{ pg_data_dir }}/pg_log，可配置日志轮转；建议结合Prometheus+Grafana监控数据库性能（工具可集成pg_exporter插件，需在配置中开启）。

总结

该工具通过自动化流程和标准化配置，大幅降低了PostgreSQL部署的复杂度，适合开发、测试及中小规模生产环境使用。使用时需重点关注配置文件的合理性（尤其是性能参数）和数据安全（备份、权限），结合实际业务需求调整参数，确保数据库稳定运行。