circleci/postgres-script-enhance

circleci/postgres 镜像文档

镜像概述

该镜像为官方Postgres Docker镜像的完整副本，唯一差异在于：/docker-entrypoint-initdb.d目录下的所有脚本在每次容器启动时都会执行，而非仅在首次初始化数据库时执行。

注意：此镜像并非面向客户的便利镜像。有关面向客户的便利镜像信息，请参考：

• [***]
• https://github.com/circleci/circleci-images

核心功能与特性

• 完全继承官方Postgres镜像的所有功能和特性
• 关键差异：/docker-entrypoint-initdb.d目录下的初始化脚本（包括.sh、.sql、.sql.gz等格式）在每次容器启动时均会执行，而官方镜像仅在首次初始化数据库时执行

使用场景

• 需要在每次容器启动时执行数据库初始化或更新脚本的场景
• 开发或测试环境中，需频繁重置或同步数据库状态的场景
• 需在容器重启后自动应用配置变更或数据更新的场景

使用方法与配置说明

基本使用

通过docker run命令启动容器，并挂载包含初始化脚本的目录到/docker-entrypoint-initdb.d：

bash
docker run -d \
  --name circleci-postgres \
  -v /本地路径/初始化脚本目录:/docker-entrypoint-initdb.d \
  -e POSTGRES_PASSWORD=mysecretpassword \
  circleci/postgres

Docker Compose配置示例

yaml
version: '3'
services:
  postgres:
    image: circleci/postgres
    volumes:
      - ./init-scripts:/docker-entrypoint-initdb.d
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: myuser
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"

环境变量配置

支持与官方Postgres镜像相同的环境变量，主要包括：

脚本执行机制

1. 将需要执行的初始化脚本（.sh、.sql、.sql.gz等格式）放置在宿主机的某个目录下
2. 通过-v参数将该目录挂载到容器内的/docker-entrypoint-initdb.d目录
3. 容器每次启动时，会按文件名排序执行该目录下的所有脚本

注意：脚本执行顺序按文件名 ASCII 排序，建议为脚本添加数字前缀（如01-init.sql、02-seed.sh）以控制执行顺序。