alectolytic/postgres

PostgreSQL on Fedora 镜像文档

镜像概述和主要用途

本镜像基于Fedora系统构建，提供PostgreSQL数据库服务。其核心特点是支持在首次启动时执行初始化脚本，方便用户进行数据库环境的快速配置和定制化设置。适用于需要灵活初始化流程的PostgreSQL部署场景。

核心功能和特性

• 基于Fedora系统，提供稳定的PostgreSQL运行环境
• 支持首次启动时执行自定义初始化脚本（*.sh格式）
• 数据目录可通过卷挂载实现持久化存储
• 可通过环境变量配置PostgreSQL关键路径和端口
• 标准PostgreSQL 5432端口暴露，便于网络访问

使用场景和适用范围

• 开发环境中快速部署带有定制化初始化的PostgreSQL实例
• 需要在数据库首次启动时自动创建用户、数据库或配置访问权限的场景
• 要求数据持久化存储的PostgreSQL服务部署
• 需要灵活调整PostgreSQL配置的应用场景

使用方法和配置说明

拉取镜像

bash
docker pull alectolytic/postgres

构建镜像（可选）

bash
docker build --tag fedora/postgres .

运行容器

bash
# 定义主机目录和端口变量
PGSQL_HOST_HOME=/pgsql/dir/on/host  # 主机上用于持久化PostgreSQL数据的目录
PGSQL_HOST_PORT=5432                # 主机映射端口

# 启动容器
docker run \
    -p 5432:${PGSQL_HOST_PORT} \    # 端口映射
    -v ${PGSQL_HOST_HOME}:/var/lib/pgsql \  # 数据卷挂载
    fedora/postgres

初始化脚本（Post-init scripts）

默认情况下不执行任何初始化脚本。如需执行，可在首次启动时通过卷挂载脚本目录：

bash
docker run \
    -p 5432:5432 \
    -v ${PGSQL_HOST_HOME}:/var/lib/pgsql \
    -v ${SCRIPT_DIR}:/usr/share/pgsql-post-init \  # 挂载脚本目录
    fedora/postgres

注意：脚本仅在首次启动（数据目录为空）时执行。如需重新执行，需删除主机数据目录后重新启动。

示例初始化脚本

以下是创建用户、数据库并配置网络访问的示例脚本：

bash
#!/usr/bin/env bash
# 创建用户、数据库并配置网络访问

DB_USER=user
DB_NAME=userdb
DB_USER_PASS=$(pwgen -c -n -1 14)  # 生成随机密码

# 创建用户和数据库
psql --command "CREATE USER ${DB_USER} WITH PASSWORD '${DB_USER_PASS}';"
/bin/createdb --owner ${DB_USER} ${DB_NAME} > /dev/null 2>&1

# 配置网络访问
echo "host ${DB_NAME} ${DB_USER} 0.0.0.0/0 md5" >> ${PGDATA}/pg_hba.conf
echo "listen_addresses = '*'" >> ${PGDATA}/postgresql.conf

环境变量

容器预定义以下环境变量，可根据需求调整：

bash
ENV PGHOME=/var/lib/pgsql        # PostgreSQL主目录
ENV PGDATA=${PGHOME}/data        # 数据库数据存储目录
ENV PGPORT=5432                  # PostgreSQL服务端口
ENV PGSHARE=/usr/share/pgsql     # PostgreSQL共享文件目录
ENV POST_INIT=/usr/share/pgsql-post-init  # 初始化脚本目录

卷

可从主机挂载以下卷：

/var/lib/pgsql

PostgreSQL主目录，包含数据库数据目录（data子目录），挂载此卷可实现数据持久化。

/usr/share/pgsql-post-init

存放初始化脚本的目录，仅在首次启动时执行目录中所有*.sh格式的脚本。脚本执行完成后，PostgreSQL服务将自动重启。

端口

• 5432：PostgreSQL默认服务端口，用于数据库客户端连接。