Docker-PostgreSQL 项目使用指南

1. 项目的目录结构及介绍

docker-postgresql/
├── CHANGELOG.md
├── Dockerfile
├── LICENSE
├── README.md
├── assets/
│   ├── backup.sh
│   ├── entrypoint.sh
│   ├── setup/
│   │   ├── 01_users_and_databases.sh
│   │   ├── 02_timezone.sh
│   │   ├── 03_postgresql.sh
│   │   └── 04_pg_hba.conf
│   └── setup.sh
├── docker-compose.yml
└── initdb/
    └── 01_init.sql

• CHANGELOG.md: 记录项目的变更日志。
• Dockerfile: 用于构建 Docker 镜像的文件。
• LICENSE: 项目的开源许可证。
• README.md: 项目的主文档，包含使用说明和介绍。
• assets/: 包含启动脚本和配置脚本。
  • backup.sh: 备份脚本。
  • entrypoint.sh: 入口点脚本，用于启动 PostgreSQL 服务。
  • setup/: 包含初始化数据库和用户的脚本。
    • 01_users_and_databases.sh: 创建用户和数据库的脚本。
    • 02_timezone.sh: 设置时区的脚本。
    • 03_postgresql.sh: 配置 PostgreSQL 的脚本。
    • 04_pg_hba.conf: PostgreSQL 的访问控制配置文件。
  • setup.sh: 初始化脚本的主入口。
• docker-compose.yml: Docker Compose 配置文件，用于定义和运行多容器应用。
• initdb/: 包含初始化数据库的 SQL 脚本。
  • 01_init.sql: 初始化数据库的 SQL 脚本。

2. 项目的启动文件介绍

entrypoint.sh

entrypoint.sh 是项目的入口点脚本，负责启动 PostgreSQL 服务。其主要功能包括：

• 检查并创建必要的目录结构。
• 运行初始化脚本 setup.sh。
• 启动 PostgreSQL 服务。

#!/bin/bash
set -e

# 创建必要的目录
mkdir -p "$PGDATA"
chmod 700 "$PGDATA"
chown -R postgres "$PGDATA"

# 运行初始化脚本
if [ ! -s "$PGDATA/PG_VERSION" ]; then
    eval "gosu postgres initdb $POSTGRES_INITDB_ARGS"
    setup.sh
fi

# 启动 PostgreSQL 服务
exec gosu postgres "$@"

3. 项目的配置文件介绍

setup/03_postgresql.sh

setup/03_postgresql.sh 是用于配置 PostgreSQL 的脚本。其主要功能包括：

• 设置 PostgreSQL 的配置参数。
• 配置监听地址和端口。
• 配置日志输出。

#!/bin/bash
set -e

# 设置 PostgreSQL 配置参数
cat >> "$PGDATA/postgresql.conf" <<EOF
listen_addresses='*'
port=5432
logging_collector=on
log_directory='pg_log'
log_filename='postgresql-%Y-%m-%d_%H%M%S.log'
EOF

# 配置监听地址和端口
echo "host all all 0.0.0.0/0 md5" >> "$PGDATA/pg_hba.conf"

docker-compose.yml

docker-compose.yml 是 Docker Compose 的配置文件，用于定义和运行多容器应用。其主要内容包括：

• 定义服务 postgresql。
• 指定镜像、端口映射、环境变量和数据卷。

version: '3.7'
services:
  postgresql:
    image: sameersbn/postgresql:latest
    ports:
      - "5432:5432"
    environment:
      - POSTGRES_USER=myuser
      - POSTGRES_PASSWORD=mypassword
      - POSTGRES_DB=mydatabase
    volumes:
      - pgdata:/var/lib/postgresql