geokrety/postgres

geokrety-postgres 镜像文档

镜像概述

geokrety-postgres是一个基于PostgreSQL的Docker镜像，预安装了PostGIS、quantile和AMQP扩展。该镜像旨在为需要地理空间数据处理、统计分析功能及消息队列集成能力的应用提供开箱即用的数据库环境。

核心功能与特性

• PostGIS扩展：提供地理空间数据类型（如点、线、面）和空间索引支持，支持地理信息查询与空间分析操作。
• quantile扩展：提供分位数计算功能，支持统计分析场景中的数据分布特征提取。
• AMQP扩展：支持与AMQP协议兼容的消息队列（如RabbitMQ）集成，实现数据库事件的消息通知机制。
• 基于官方PostgreSQL镜像：继承官方PostgreSQL镜像的稳定性与安全性，支持标准PostgreSQL功能及配置。

使用场景

• 地理信息系统（GIS）应用：需存储和查询地理空间数据的应用，如地图服务、位置追踪系统、地理编码服务等。
• 统计分析系统：需进行分位数计算等统计分析的业务系统，如数据报表平台、趋势分析工具、科学研究数据处理等。
• 消息驱动型应用：需通过消息队列实现数据库事件通知的服务，如数据同步服务、实时数据处理流程、分布式系统事件协调等。

使用方法

基本运行

使用以下命令启动容器：

bash
docker run -d \
  --name geokrety-postgres \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 \
  geokrety/geokrety-postgres

持久化数据

通过数据卷挂载实现数据库数据持久化：

bash
docker run -d \
  --name geokrety-postgres \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -v postgres_data:/var/lib/postgresql/data \
  -p 5432:5432 \
  geokrety/geokrety-postgres

验证扩展安装

进入容器并通过psql验证扩展是否正确安装：

bash
docker exec -it geokrety-postgres psql -U myuser -d mydb

在psql终端中执行以下SQL查询：

sql
SELECT extname, extversion FROM pg_extension WHERE extname IN ('postgis', 'quantile', 'amqp');

若返回包含上述扩展名称及版本的记录，表明扩展安装成功。

环境变量配置

支持官方PostgreSQL镜像的所有标准环境变量，主要包括：

• POSTGRES_USER：数据库管理员用户名（默认值：postgres）
• POSTGRES_PASSWORD：数据库管理员密码（必填项）
• POSTGRES_DB：初始化的数据库名称（默认与POSTGRES_USER相同）
• PGDATA：数据库数据存储路径（默认值：/var/lib/postgresql/data）

docker-compose配置示例

yaml
version: '3'
services:
  postgres:
    image: geokrety/geokrety-postgres
    container_name: geokrety-postgres
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data: