runci/postgres

PostgreSQL Relay数据库容器镜像

镜像概述

该镜像为基于PostgreSQL的数据库容器，专为Relay服务设计。其核心特性是包含预配置的SQL初始化脚本，在容器首次启动时自动执行，以创建Relay服务所需的数据库模式，简化部署流程。

核心功能与特性

• 基础数据库功能：基于官方PostgreSQL镜像，提供完整的PostgreSQL数据库服务
• 自动模式初始化：包含位于/docker-entrypoint-initdb.d/bootstrap.sql的SQL脚本，容器首次启动时自动执行
• 简化部署流程：无需手动执行SQL脚本，容器创建过程中自动完成数据库模式创建
• 标准兼容性：遵循PostgreSQL官方镜像规范，支持标准环境变量配置

使用场景

适用于需要快速部署Relay服务并依赖PostgreSQL数据库的场景，包括：

• 开发环境中快速搭建Relay服务的数据库环境
• 测试环境中自动化部署带有预配置模式的数据库
• 生产环境中简化Relay服务的数据库初始化流程

使用方法与配置说明

基本使用（docker run）

通过以下命令启动容器，自动初始化数据库模式：

bash
docker run -d \
  --name relay-postgres \
  -e POSTGRES_USER=relayuser \
  -e POSTGRES_PASSWORD=relaypass \
  -e POSTGRES_DB=relaydb \
  -p 5432:5432 \
  [镜像名称]

环境变量配置

支持PostgreSQL官方镜像的标准环境变量，常用配置如下：

初始化脚本说明

容器启动时，PostgreSQL入口点会自动执行/docker-entrypoint-initdb.d目录下的所有.sql脚本。本镜像中的bootstrap.sql脚本负责：

• 创建Relay服务所需的数据库表结构
• 配置必要的索引和约束
• 初始化基础数据（如适用）

Docker Compose配置示例

以下是与Relay服务配合使用的docker-compose.yml示例：

yaml
version: '3.8'

services:
  postgres:
    image: docker.xuanyuan.run/[镜像名称]
    container_name: relay-postgres
    environment:
      POSTGRES_USER: relayuser
      POSTGRES_PASSWORD: relaypass
      POSTGRES_DB: relaydb
    volumes:
      - postgres-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    restart: unless-stopped

  relay-service:
    image: docker.xuanyuan.run/[relay服务镜像]
    depends_on:
      - postgres
    environment:
      DATABASE_URL: postgresql://relayuser:relaypass@postgres:5432/relaydb

volumes:
  postgres-data:

数据持久化

通过挂载卷/var/lib/postgresql/data可实现数据库数据的持久化存储，避免容器重启后数据丢失。