praiskup/postgresql

PostgreSQL Docker容器

镜像概述和主要用途

本镜像提供基于cont-postgresql API的PostgreSQL数据库容器，目前支持CentOS和Fedora系统。项目主页为https://github.com/devexp-db/cont-postgresql，欢迎贡献；镜像由https://github.com/devexp-db/cont-postgresql-generated构建。

该镜像旨在提供稳定、清晰且功能丰富的API，便于用户通过Docker部署和管理PostgreSQL数据库，支持跨不同Linux发行版的容器迁移。

核心功能和特性

稳定的API设计

• 提供明确的数据目录（datadir）路径
• 支持环境变量配置
• 包含shell钩子目录，便于自定义初始化和运行时操作

API版本控制

镜像标签（TAG）的第一部分表示API版本（如postgresql:APIv1-centos7），确保API兼容性。使用相同API版本的镜像（如APIv1-centos7和APIv1-fedora23）可无缝迁移容器管理脚本。

发行版差异说明

CentOS和Fedora通常提供不同版本的PostgreSQL服务器，因此外部数据目录不会自动迁移，需手动处理版本兼容性。

使用场景和适用范围

• 开发和测试环境中的PostgreSQL快速部署
• 需要跨CentOS和Fedora系统迁移容器管理脚本的场景
• 需通过环境变量和钩子目录自定义数据库配置的场景

使用方法和配置说明

拉取镜像

根据所需API版本和基础系统拉取镜像：

bash
docker pull docker.xuanyuan.run/postgresql:APIv1-centos7
# 或
docker pull docker.xuanyuan.run/postgresql:APIv1-fedora23

运行容器

基本运行命令（需调整数据目录等参数）：

bash
docker run -d \
  --name postgres-container \
  -v /host/path/to/datadir:/var/lib/postgresql/data \  # 挂载数据目录
  postgresql:APIv1-centos7

环境变量配置

镜像接受环境变量用于配置PostgreSQL，具体支持的变量可参考项目文档。常见配置可能包括数据库用户名、密码、数据库名称等（以项目最新文档为准）。

钩子目录

容器包含shell钩子目录，用户可将自定义脚本放入这些目录，在容器启动或运行时执行，实现初始化配置、数据迁移等自定义操作。具体路径可参考项目文档。

注意事项

• 不同基础系统（CentOS/Fedora）的PostgreSQL版本可能不同，迁移外部数据目录时需确保版本兼容性
• 始终使用指定API版本的镜像标签（如APIv1-*）以保证API兼容性