coreroller/postgres

CoreRoller PostgreSQL镜像

概述

CoreRoller PostgreSQL镜像是基于官方postgres:9.4镜像构建的专用数据库镜像，专为CoreRoller项目设计。该镜像预安装了CoreRoller运行必需的两个PostgreSQL扩展：semver（用于版本比较）和uuid-ossp（用于生成UUID），并自动配置CoreRoller所需的数据库环境，简化CoreRoller部署流程。

核心功能

• 基于官方基础镜像：构建于官方postgres:9.4镜像，确保数据库稳定性与兼容性
• 预安装必要扩展：包含CoreRoller必需的semver和uuid-ossp扩展，无需手动配置
• 自动数据库初始化：自动创建CoreRoller运行所需的数据库结构
• 数据持久化支持：支持通过卷挂载实现数据库数据持久化，避免数据丢失

使用场景

作为CoreRoller后端服务（rollerd）的专用数据库存储，适用于：

• CoreRoller开发环境部署
• CoreRoller生产环境数据库服务
• 需要与CoreRoller后端集成的容器化部署场景

使用方法

基本部署

使用以下命令启动CoreRoller PostgreSQL容器：

bash
docker run -d \
  --name coreroller-postgres \
  -p 5432:5432 \
  -v coreroller-postgres-data:/var/lib/postgresql/data \
  docker.xuanyuan.run/coreroller/postgres

数据卷配置

为确保数据持久化，必须挂载数据卷到PostgreSQL数据目录：

bash
# 使用命名卷（推荐）
docker run -d \
  --name coreroller-postgres \
  -p 5432:5432 \
  -v coreroller-postgres-data:/var/lib/postgresql/data \
  docker.xuanyuan.run/coreroller/postgres

# 或使用主机目录
docker run -d \
  --name coreroller-postgres \
  -p 5432:5432 \
  -v /path/on/host:/var/lib/postgresql/data \
  docker.xuanyuan.run/coreroller/postgres

环境变量配置

可通过环境变量自定义数据库配置：

示例配置：

bash
docker run -d \
  --name coreroller-postgres \
  -p 5432:5432 \
  -v coreroller-postgres-data:/var/lib/postgresql/data \
  -e POSTGRES_USER=coreroller \
  -e POSTGRES_PASSWORD=securepassword \
  -e POSTGRES_DB=coreroller \
  docker.xuanyuan.run/coreroller/postgres

与CoreRoller后端集成（docker-compose）

使用docker-compose实现CoreRoller完整部署：

yaml
version: '3'
services:
  postgres:
    image: docker.xuanyuan.run/coreroller/postgres
    volumes:
      - coreroller-postgres-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=coreroller
      - POSTGRES_PASSWORD=securepassword
      - POSTGRES_DB=coreroller
    ports:
      - "5432:5432"
    restart: unless-stopped
  
  rollerd:
    image: docker.xuanyuan.run/coreroller/rollerd
    depends_on:
      - postgres
    environment:
      - DB_HOST=postgres
      - DB_USER=coreroller
      - DB_PASSWORD=securepassword
      - DB_NAME=coreroller
    ports:
      - "8000:8000"
    restart: unless-stopped

volumes:
  coreroller-postgres-data:

注意事项

• 生产环境安全：必须通过POSTGRES_PASSWORD设置强密码，避免使用默认空密码
• 数据备份：定期备份挂载的卷数据，防止数据丢失
• 版本兼容性：该镜像基于PostgreSQL 9.4，与CoreRoller所有版本兼容
• 扩展依赖：semver和uuid-ossp扩展为CoreRoller核心依赖，不可移除