rticontest/postgis

PostgreSQL with PostGIS Docker镜像文档

镜像概述

本Docker镜像基于bitnami/postgresql官方镜像构建，通过扩展集成了PostGIS插件，提供了完整的PostgreSQL数据库功能及空间数据处理能力。该镜像保持了与bitnami/postgresql原镜像的完全兼容性，支持原镜像的所有配置参数、环境变量及部署方式，可无缝对接bitnami的PostgreSQL Helm chart进行Kubernetes部署。

核心功能和特性

• 完整PostgreSQL功能：继承bitnami/postgresql镜像的全部数据库功能，包括数据持久化、用户管理、权限控制等
• PostGIS空间扩展：集成PostGIS插件，支持地理空间数据类型（如Geometry、Geography）及空间查询功能
• 配置兼容性：完全兼容bitnami/postgresql镜像的所有环境变量、配置文件及部署模式
• Helm chart支持：可直接与bitnami/postgresql Helm chart配合使用，无需额外修改

使用场景和适用范围

• 需要存储和查询地理空间数据的应用系统
• GIS（地理信息系统）相关应用开发与部署
• 地图服务、位置分析等空间数据处理场景
• 基于PostgreSQL的空间数据仓库构建

使用方法和配置说明

基础使用

Docker Run命令示例

bash
docker run -d \
  --name postgresql-postgis \
  -e POSTGRESQL_USERNAME=myuser \
  -e POSTGRESQL_PASSWORD=mypassword \
  -e POSTGRESQL_DATABASE=mydb \
  -p 5432:5432 \
  -v postgresql-data:/bitnami/postgresql \
  [镜像名称]

Docker Compose配置示例

yaml
version: '3'
services:
  postgresql-postgis:
    image: docker.xuanyuan.run/[镜像名称]
    container_name: postgresql-postgis
    environment:
      - POSTGRESQL_USERNAME=myuser
      - POSTGRESQL_PASSWORD=mypassword
      - POSTGRESQL_DATABASE=mydb
    ports:
      - "5432:5432"
    volumes:
      - postgresql-data:/bitnami/postgresql
    restart: unless-stopped

volumes:
  postgresql-data:

配置参数说明

所有配置参数及环境变量与bitnami/postgresql镜像完全一致，详细说明请参考：

• https://hub.docker.com/r/bitnami/postgresql
• https://github.com/bitnami/containers/blob/main/bitnami/postgresql/README.md

验证PostGIS安装

容器启动后，可通过以下方式验证PostGIS是否正确安装：

bash
# 进入容器
docker exec -it postgresql-postgis psql -U myuser -d mydb

# 在PostgreSQL终端执行
SELECT postgis_version();

若返回PostGIS版本信息，则表示安装成功。

Helm Chart部署

该镜像可直接用于bitnami/postgresql Helm chart部署，只需在values.yaml中指定镜像信息：

yaml
image:
  registry: [镜像仓库地址]
  repository: [镜像名称]
  tag: [镜像标签]

其他配置参数与bitnami/postgresql Helm chart完全兼容，详细配置请参考官方Helm chart文档。