使用***PostgreSQL Docker镜像创建多个数据库

镜像概述和主要用途

本工具基于***PostgreSQL Docker镜像扩展，利用其提供的初始化机制，通过脚本在容器启动时自动创建多个数据库。***PostgreSQL镜像支持在/docker-entrypoint-initdb.d目录下执行*.sql、*.sql.gz或*.sh脚本进行初始化操作，本工具正是基于这一机制实现多数据库自动创建功能。

核心功能和特性

• 支持通过环境变量POSTGRES_MULTIPLE_DATABASES指定多个数据库名称（逗号分隔）
• 提供两种使用方式：挂载卷直接使用或构建自定义镜像
• 兼容***PostgreSQL镜像的用户认证机制（支持POSTGRES_USER和POSTGRES_PASSWORD环境变量）
• 支持非标准数据库名（含连字符、大写字母等特殊字符）

使用场景和适用范围

适用于需要在单个PostgreSQL容器中初始化多个数据库的场景，例如：

• 多模块应用需要独立数据库实例
• 开发环境中需要同时初始化测试库和开发库
• 微服务架构中共享PostgreSQL容器但需要隔离数据的场景

使用方法和配置说明

通过挂载卷使用

1. 克隆仓库，将仓库目录挂载为卷到容器的/docker-entrypoint-initdb.d目录
2. 通过POSTGRES_MULTIPLE_DATABASES环境变量指定数据库名称（逗号分隔）
3. 配置POSTGRES_USER和POSTGRES_PASSWORD等认证信息

docker-compose配置示例：

myapp-postgresql:
    image: postgres:9.6.2
    volumes:
        - ../docker-postgresql-multiple-databases:/docker-entrypoint-initdb.d
    environment:
        - POSTGRES_MULTIPLE_DATABASES=db1,db2
        - POSTGRES_USER=myapp
        - POSTGRES_PASSWORD=

通过构建自定义镜像使用

1. 克隆仓库，构建自定义镜像并推送到私有仓库（以Google私有仓库为例）：

   docker build --tag=eu.gcr.io/your-project/postgres-multi-db .
   gcloud docker -- push eu.gcr.io/your-project/postgres-multi-db
   

2. 使用自定义镜像时仍需传递POSTGRES_MULTIPLE_DATABASES环境变量：

   myapp-postgresql:
       image: eu.gcr.io/your-project/postgres-multi-db
       environment:
           - POSTGRES_MULTIPLE_DATABASES=db1,db2
           - POSTGRES_USER=myapp
           - POSTGRES_PASSWORD=
   

非标准数据库名处理

若需使用含连字符、大写字母等非标准数据库名，需在POSTGRES_MULTIPLE_DATABASES中用引号括起数据库名：

environment:
    - POSTGRES_MULTIPLE_DATABASES="test-db-1","test-db-2"

环境变量说明