hzibraunschweig/sormas-postgres

Container Postgres

镜像概述和主要用途

该容器是SORMAS（Surveillance, Outbreak Response Management and Analysis System）系统的专用PostgreSQL数据库组件，基于官方postgres:10-alpine镜像构建。其主要用途是为SORMAS系统提供预配置的数据库环境，通过优化配置和自动初始化流程，确保数据库环境满足SORMAS系统的部署要求。

核心功能和特性

基础镜像与配置优化

• 基于官方postgres:10-alpine轻量级镜像构建
• 预配置/etc/postgresql/postgresql.conf文件，设置max_prepared_transactions = 110，解决SORMAS部署的特定需求

自动初始化机制

容器启动时自动执行/docker-entrypoint-initdb.d/setup_sormas.sh初始化脚本，完成以下关键操作：

• 创建SORMAS专用数据库用户及密码（通过环境变量指定）
• 创建两个数据库：主数据库（DB_NAME）和审计数据库（DB_NAME_AUDIT），均采用UTF8编码，所有者为SORMAS用户
• 为主数据库配置必要组件：
  • 创建plpgsql存储过程语言并修改所有者
  • 安装 temporal_tables、pg_trgm、pgcrypto扩展
  • 授予SORMAS用户对public模式下所有函数的执行权限
• 为审计数据库配置plpgsql扩展及注释

使用场景和适用范围

该容器专门用于部署SORMAS系统的环境，作为SORMAS系统的数据库服务组件，提供数据存储、管理及扩展支持，确保SORMAS系统正常运行所需的数据库环境一致性和兼容性。

使用方法和配置说明

环境变量配置

容器运行前需通过环境变量指定以下参数：

Docker部署示例

1. 使用docker run命令部署

bash
docker run -d \
  --name sormas-postgres \
  -e SORMAS_POSTGRES_USER=sormasuser \
  -e SORMAS_POSTGRES_PASSWORD=your_secure_password \
  -e DB_NAME=sormas_db \
  -e DB_NAME_AUDIT=sormas_db_audit \
  -v sormas-postgres-data:/var/lib/postgresql/data \
  --restart unless-stopped \
  sormas/postgres

2. 使用docker-compose配置部署

yaml
version: '3'
services:
  sormas-postgres:
    image: sormas/postgres
    container_name: sormas-postgres
    environment:
      - SORMAS_POSTGRES_USER=sormasuser
      - SORMAS_POSTGRES_PASSWORD=your_secure_password
      - DB_NAME=sormas_db
      - DB_NAME_AUDIT=sormas_db_audit
    volumes:
      - sormas-postgres-data:/var/lib/postgresql/data  # 持久化存储数据库数据
    restart: unless-stopped  # 容器异常退出时自动重启

volumes:
  sormas-postgres-data:  # 定义命名卷用于数据持久化

初始化流程说明

容器首次启动时执行的关键SQL操作（通过初始化脚本实现）：

sql
-- 创建SORMAS用户
CREATE USER ${SORMAS_POSTGRES_USER} WITH PASSWORD '${SORMAS_POSTGRES_PASSWORD}' CREATEDB;

-- 创建主数据库和审计数据库
CREATE DATABASE ${DB_NAME} WITH OWNER = '${SORMAS_POSTGRES_USER}' ENCODING = 'UTF8';
CREATE DATABASE ${DB_NAME_AUDIT} WITH OWNER = '${SORMAS_POSTGRES_USER}' ENCODING = 'UTF8';

-- 配置主数据库
\c ${DB_NAME}
CREATE OR REPLACE PROCEDURAL LANGUAGE plpgsql;
ALTER PROCEDURAL LANGUAGE plpgsql OWNER TO ${SORMAS_POSTGRES_USER};
CREATE EXTENSION temporal_tables;
CREATE EXTENSION pg_trgm;
CREATE EXTENSION pg***;
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO ${SORMAS_POSTGRES_USER};

-- 配置审计数据库
\c ${DB_NAME_AUDIT}
CREATE EXTENSION IF NOT EXISTS plpgsql WITH SCHEMA pg_catalog;
COMMENT ON EXTENSION plpgsql IS 'PL/pgSQL procedural language';
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO ${SORMAS_POSTGRES_USER};