dspace/dspace-postgres-loadsql

PostgreSQL 增强镜像文档

镜像概述

本镜像基于PostgreSQL构建，扩展集成了curl工具，并配置为在容器初始化阶段自动加载指定的数据库备份文件。旨在简化带有预设数据的PostgreSQL环境部署流程，适用于需要快速搭建包含基础数据的数据库服务场景。

核心功能与特性

• 集成curl工具：内置curl命令，支持从HTTP/HTTPS等网络地址下载数据库备份文件
• 自动数据初始化：容器启动时自动加载指定的数据库备份，无需手动执行导入操作
• 兼容官方PostgreSQL：基于官方PostgreSQL镜像构建，保留其所有原生功能与配置方式
• 简化部署流程：通过环境变量配置即可完成数据初始化，减少手动操作步骤

使用场景

• 开发环境快速搭建：快速部署包含测试数据的数据库环境，无需手动导入数据
• 测试环境标准化：确保测试环境使用一致的初始数据，提高测试可重复性
• 演示环境部署：快速搭建带有示例数据的演示数据库，便于功能展示
• CI/CD流程集成：在自动化测试流程中自动部署包含特定数据的数据库实例

使用方法与配置说明

环境变量配置

Docker Run 示例

bash
docker run -d \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -e DB_DUMP_URL=https://example.com/initial-db.sql \
  -p 5432:5432 \
  --name my-postgres \
  [镜像名称]

Docker Compose 示例

yaml
version: '3'
services:
  postgres:
    image: [镜像名称]
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
      DB_DUMP_URL: https://example.com/initial-db.sql
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

工作流程说明

1. 容器启动时，首先执行PostgreSQL官方初始化脚本
2. 初始化完成后，通过curl从DB_DUMP_URL下载数据库备份文件
3. 自动将下载的备份文件导入到指定的POSTGRES_DB数据库中
4. 完成后，数据库服务正常启动，可通过标准PostgreSQL客户端连接访问

注意事项

• 确保DB_DUMP_URL指向的备份文件可公开访问或配置了适当的认证
• 备份文件需为SQL格式，兼容PostgreSQL导入语法
• 大型备份文件可能会延长容器启动时间，请合理规划部署流程
• 建议配合数据卷使用，以持久化存储数据库数据