jore4-postgres Docker镜像文档

镜像概述

jore4-postgres是为Jore4交通规划系统量身定制的PostgreSQL数据库镜像，基于官方PostgreSQL镜像构建，集成了Jore4项目所需的数据库模式、初始化SQL脚本及配置文件，旨在简化Jore4应用的数据库环境部署流程，确保开发、测试与生产环境中数据库配置的一致性。

核心功能与特性

• 预配置数据库结构：内置Jore4系统所需的表结构、索引及关系定义，无需手动执行 schema 创建脚本
• 自动化初始化：包含初始化SQL脚本，启动时自动完成数据库用户、权限及基础数据的配置
• 环境适配性：支持通过环境变量灵活配置数据库参数，适配开发、测试、生产等不同环境需求
• 版本兼容性：基于特定版本的官方PostgreSQL构建，确保与Jore4应用版本的兼容性
• 数据持久化支持：兼容PostgreSQL官方数据卷挂载方式，保障数据持久化存储

使用场景

• 本地开发环境：开发者可快速启动包含完整Jore4数据库结构的本地环境，无需手动配置数据库
• 集成测试：在CI/CD流程中作为测试环境的数据库服务，提供一致的测试数据基础
• 演示环境：用于快速部署Jore4系统演示实例，减少环境配置时间
• 开发团队协作：统一团队成员的数据库环境，避免因本地数据库配置差异导致的问题

使用方法

基础使用（docker run）

docker run -d \
  --name jore4-postgres \
  -p 5432:5432 \
  -e POSTGRES_USER=jore4user \
  -e POSTGRES_PASSWORD=jore4pass \
  -e POSTGRES_DB=jore4db \
  -v jore4-postgres-data:/var/lib/postgresql/data \
  hsldevcom/jore4-postgres:latest

Docker Compose配置示例

创建docker-compose.yml文件：

version: '3.8'
services:
  jore4-postgres:
    image: hsldevcom/jore4-postgres:latest
    container_name: jore4-postgres
    ports:
      - "5432:5432"
    environment:
      POSTGRES_USER: jore4user
      POSTGRES_PASSWORD: jore4pass
      POSTGRES_DB: jore4db
      # 可选：调整数据库连接参数
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=en_US.UTF-8 --lc-ctype=en_US.UTF-8"
    volumes:
      - jore4-postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  jore4-postgres-data:

启动服务：

docker-compose up -d

配置参数

环境变量

数据持久化

通过挂载Docker卷或主机目录至容器内/var/lib/postgresql/data目录实现数据持久化，如上述docker run及docker-compose示例中的-v jore4-postgres-data:/var/lib/postgresql/data配置。

注意事项

• 版本匹配：使用时需确保镜像版本与Jore4应用版本匹配，避免因数据库结构变更导致的兼容性问题
• 密码安全：生产环境中应通过环境变量或密钥管理工具设置强密码，避免使用默认密码
• 数据备份：定期备份持久化卷中的数据，以防数据丢失
• 资源限制：根据实际负载调整容器CPU/内存资源限制，避免性能瓶颈

镜像维护与更新

镜像由Jore4开发团队维护，更新通常伴随Jore4系统版本迭代，包含数据库结构变更或安全补丁。建议定期关注GitHub仓库获取更新信息。