Docker构建Postgres镜像时预导入SQL dump生成预填充镜像方案咨询

核心思路 #

官方Postgres镜像的/docker-entrypoint-initdb.d/脚本仅在容器首次启动时执行，我们只需要在镜像构建的RUN阶段手动触发一次初始化逻辑，完成数据写入后清理临时文件，就能把预填充的数据永久打包到镜像里，容器启动时直接加载已有数据，无需再执行初始化脚本。

修改后的Dockerfile #

FROM postgres:11.12

LABEL maintainer="Hello Stackoverflow"

ARG POSTGRES_VERSION="11.12"
ARG TZ="Europe/Berlin"

ENV TZ ${TZ}
ENV LANG de_DE.UTF-8
ENV LANGUAGE de_DE.UTF-8
ENV LC_ALL de_DE.UTF-8
ENV POSTGRES_PASSWORD 'blabla'
ENV POSTGRES_HOST_AUTH_METHOD trust
# 显式指定数据存储目录，避免版本变动导致路径异常
ENV PGDATA /var/lib/postgresql/data

RUN set -x && \
    localedef -i de_DE -c -f UTF-8 -A /usr/share/locale/locale.alias de_DE.UTF-8

# 复制初始化脚本到指定目录
COPY test-data/. /docker-entrypoint-initdb.d/

# 核心逻辑：构建阶段预执行数据导入
RUN set -eux; \
    # 给自定义导入脚本加执行权限
    chmod +x /docker-entrypoint-initdb.d/*.sh; \
    # 临时启动Postgres服务，关闭外网监听保证构建安全
    su - postgres -c "pg_ctl -D \"$PGDATA\" -o \"-c listen_addresses=''\" -w start"; \
    # 触发官方初始化逻辑，执行所有initdb.d下的脚本完成数据导入
    docker-entrypoint.sh postgres --bootstrap; \
    # 停止临时Postgres进程
    su - postgres -c "pg_ctl -D \"$PGDATA\" -m fast -w stop"; \
    # 清理初始化脚本，避免容器启动时重复执行报错
    rm -rf /docker-entrypoint-initdb.d/*

CMD ["postgres"]

注意事项 #

• 如果你的数据导入脚本依赖外部服务，需要保证构建镜像的环境网络可以正常访问对应服务
• 若导入的数据量较大，可以在构建时开启Docker Buildkit优化构建缓存，减少重复构建的耗时
• 镜像构建完成后可以本地启动验证，容器启动时间会从原来的2分钟缩短到秒级

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