如何优雅实现PostgreSQL/MySQL容器每次启动执行幂等初始化脚本？

针对你提出的两个方案，以下是具体实现方式和优劣分析：

方案一：在官方Entrypoint之后、启动PostgreSQL之前插入执行命令 #

不需要修改官方的docker-entrypoint.sh，而是通过包装官方Entrypoint的方式，在保留其原有逻辑的基础上，添加自定义脚本执行步骤。

实现步骤： #

1. 编写自定义Entrypoint脚本（例如my-entrypoint.sh）：

#!/bin/bash
# 启动官方Entrypoint（后台运行，保留其初始化/启动逻辑）
/docker-entrypoint.sh "$@" &
postgres_pid=$!

# 等待PostgreSQL服务就绪
until pg_isready -U postgres -h localhost; do
  echo "Waiting for PostgreSQL to accept connections..."
  sleep 2
done

# 执行幂等初始化脚本
psql -U postgres -d postgres -f /opt/idempotent_init.sql

# 等待PostgreSQL主进程结束，维持容器运行状态
wait $postgres_pid

2. 构建自定义镜像（或通过docker run挂载脚本）：

FROM postgres:latest
# 复制幂等脚本到容器内
COPY idempotent_init.sql /opt/
# 复制自定义Entrypoint并赋予执行权限
COPY my-entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/my-entrypoint.sh
# 设置自定义Entrypoint
ENTRYPOINT ["my-entrypoint.sh"]
CMD ["postgres"]

优势： #

• 完全保留官方Entrypoint的所有功能（包括首次初始化逻辑），上游镜像更新时无需同步修改脚本，兼容性好
• 所有逻辑在单个容器内完成，部署结构简洁

方案二：使用独立的初始化容器（Sidecar） #

通过一个依赖PostgreSQL容器的独立容器，每次PostgreSQL启动后自动执行幂等脚本，执行完成后容器退出。

实现示例（Docker Compose）： #

version: '3.8'
services:
  postgres:
    image: postgres:latest
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: your_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  db-init:
    image: postgres:latest
    depends_on:
      - postgres
    volumes:
      - ./idempotent_init.sql:/tmp/idempotent_init.sql
    environment:
      PGPASSWORD: your_password
    command: >
      sh -c '
        until pg_isready -U postgres -h postgres; do
          echo "Waiting for PostgreSQL..."
          sleep 2
        done
        psql -U postgres -h postgres -d postgres -f /tmp/idempotent_init.sql
      '
volumes:
  postgres_data:

优势： #

• 无需修改PostgreSQL容器的任何配置，完全解耦初始化逻辑
• 适合已有现成PostgreSQL部署，不想改动原有容器配置的场景

方案选择建议 #

• 如果希望部署结构简单、容器逻辑紧凑，优先选择方案一
• 如果追求逻辑解耦、不想改动原有PostgreSQL容器配置，优先选择方案二

通用注意事项 #

• 确保idempotent_init.sql是完全幂等的，例如使用CREATE TABLE IF NOT EXISTS、INSERT ... ON CONFLICT DO NOTHING等语法，避免重复执行报错
• 必须添加数据库就绪等待逻辑，否则脚本可能在PostgreSQL未启动完成时执行，导致连接失败

内容的提问来源于stack exchange，提问作者Nathan