Fedora PostgreSQL Docker镜像文档

镜像概述和主要用途

本镜像基于Fedora操作系统构建，用于快速部署PostgreSQL数据库服务。提供隔离、轻量级的运行环境，支持数据持久化存储和灵活的网络配置，适用于开发、测试及轻量级生产场景中的PostgreSQL部署需求。

核心功能和特性

• 基于Fedora系统：采用Fedora作为基础镜像，提供稳定的操作系统环境。
• 数据持久化：支持通过挂载主机目录到容器内/var/lib/pgsql/data目录，实现数据库数据的持久化存储。
• 灵活端口映射：支持指定主机端口映射或随机端口映射，适配不同网络环境需求。
• 内置帮助机制：通过执行container-usage命令可获取容器使用说明，包括数据库初始化配置指南。
• 权限适配：需配置数据目录权限以匹配容器内PostgreSQL用户（UID/GID 26），确保数据读写正常。

使用场景和适用范围

• 开发环境：快速搭建隔离的PostgreSQL实例，用于应用程序开发调试。
• 测试环境：部署临时数据库服务，支持快速启停和数据重置，满足自动化测试需求。
• 学环境**：提供独立的PostgreSQL运行环境，适合数据库学**和实践操作。
• 轻量级服务：适用于对资源要求较低、无需复杂集群配置的单节点数据库服务场景。

详细使用方法和配置说明

1. 构建镜像

从源码构建镜像的步骤如下：

# 克隆源码后执行构建命令，--rm 表示构建后删除中间容器，-t 指定镜像标签
docker build --rm -t username/postgresql . |& tee postgres_build.log

说明：tee postgres_build.log 用于将构建日志输出到文件，便于问题排查。

2. 获取帮助信息

运行容器时执行 container-usage 命令可获取详细使用说明（如数据库初始化、管理员密码设置等）：

docker run username/postgresql container-usage

3. 运行容器

3.1 基础运行（指定端口映射）

若主机5432端口未被占用，可直接映射容器5432端口到主机：

# 创建数据目录并配置权限（容器内PostgreSQL用户UID/GID为26）
mkdir data
chown 26:26 data
# 若主机启用SELinux，需设置文件上下文
chcon -t svirt_sandbox_file_t data

# 启动容器，挂载数据卷并映射端口
docker run -v "$(pwd)/data:/var/lib/pgsql/data" -d -p 5432:5432 username/postgresql

3.2 随机端口映射

若主机5432端口已占用，可让Docker随机分配主机端口：

# 数据目录准备（同3.1）
mkdir data && chown 26:26 data && chcon -t svirt_sandbox_file_t data

# 启动容器，仅指定容器端口，主机端口随机分配
docker run -v "$(pwd)/data:/var/lib/pgsql/data" -d -p 5432 username/postgresql

# 查看随机映射的主机端口
docker ps

4. 测试连接

4.1 获取容器信息

# 查看运行中的容器ID
docker ps

# 获取容器IP地址（替换<container_id>为实际容器ID）
docker inspect --format '{{ .NetworkSettings.IPAddress }}' <container_id>

4.2 连接数据库

使用 psql 客户端连接容器内PostgreSQL服务：

# 替换<container_ip>为实际容器IP
psql -h <container_ip> -U postgres

注意：初始状态下无默认数据库，且postgres管理员用户无默认密码。需参考 container-usage 输出的说明进行初始化配置。

Docker部署方案示例

示例1：使用docker run快速启动（随机端口）

# 创建并配置数据目录
mkdir -p /opt/postgres/data && chown 26:26 /opt/postgres/data && chcon -t svirt_sandbox_file_t /opt/postgres/data

# 启动容器，随机端口映射
docker run -v /opt/postgres/data:/var/lib/pgsql/data -d -p 5432 --name postgres-demo username/postgresql

# 查看容器状态及随机端口
docker ps --filter "name=postgres-demo"

示例2：docker-compose配置（指定端口）

创建 docker-compose.yml 文件：

version: '3'
services:
  postgres:
    image: username/postgresql
    container_name: postgres-service
    volumes:
      - ./data:/var/lib/pgsql/data  # 挂载当前目录下data文件夹作为数据卷
    ports:
      - "5432:5432"  # 主机5432端口映射到容器5432端口
    restart: unless-stopped  # 除非手动停止，否则容器退出时自动重启

启动服务：

# 初始化数据目录权限
mkdir data && chown 26:26 data && chcon -t svirt_sandbox_file_t data

# 启动容器（后台运行）
docker-compose up -d

# 查看服务状态
docker-compose ps

注意事项

1. 数据目录权限：容器内PostgreSQL进程使用UID/GID 26运行，需确保主机挂载的 data 目录权限为 26:26，否则可能导致数据读写失败。
2. SELinux配置：若主机启用SELinux，需执行 chcon -t svirt_sandbox_file_t data 配置目录上下文，避免权限被SELinux阻止。
3. 初始化配置：默认无预设数据库和管理员密码，需通过 docker run username/postgresql container-usage 查看帮助文档，完成数据库初始化设置。
4. 端口冲突：若主机5432端口已被占用，建议使用随机端口映射（-p 5432）或修改主机映射端口（如 -p 5433:5432）。