epolyakov/postgis

镜像概述

本镜像基于PostGIS构建，扩展了LTREE数据类型支持，并提供了灵活的数据库初始化机制。它旨在满足需要空间数据处理能力同时依赖树形数据结构（LTREE）的应用场景，同时支持在数据库服务启动后执行自定义初始化脚本。

核心功能与特性

1. LTREE扩展默认启用：已将LTREE扩展添加到PostGIS模板数据库中，默认启用，无需手动配置即可使用LTREE数据类型及相关函数。

2. 增强的初始化脚本支持：引入/setup-additional.sh脚本执行机制。与传统的/docker-entrypoint-initdb.d/*脚本（仅在数据库首次初始化时执行）不同，/setup-additional.sh在数据库引擎运行状态下执行，适用于需要在服务启动后动态执行的初始化逻辑。

使用场景

• 需要同时使用PostGIS空间数据功能和LTREE树形数据结构的应用（如地理信息系统结合层级分类数据）。
• 需要在数据库服务启动后执行初始化操作（如动态配置、数据同步等）的场景。
• 开发或生产环境中需要简化LTREE扩展配置流程的PostgreSQL部署。

使用方法

基本使用

直接运行镜像即可获得包含LTREE扩展的PostGIS服务：

bash
docker run -d --name postgis-ltree -e POSTGRES_PASSWORD=mysecretpassword your-image-name

自定义初始化脚本

如需使用/setup-additional.sh执行额外初始化操作，可通过挂载方式提供脚本：

1. 创建自定义脚本文件（如./setup-additional.sh），内容示例：

   bash
   #!/bin/bash
   # 示例：创建使用LTREE类型的表
   psql -U postgres -d mydb -c "CREATE TABLE categories (id SERIAL PRIMARY KEY, path ltree);"
   

2. 运行容器时挂载脚本：

   bash
   docker run -d --name postgis-ltree \
     -e POSTGRES_PASSWORD=mysecretpassword \
     -v $(pwd)/setup-additional.sh:/setup-additional.sh \
     your-image-name
   

   容器启动后，/setup-additional.sh将在数据库引擎运行状态下自动执行。

注意事项

• setup-additional.sh需具有可执行权限（可通过chmod +x setup-additional.sh设置）。
• 脚本中数据库操作需使用正确的数据库用户（默认postgres）及连接参数。

部署示例（docker-compose）

yaml
version: '3'
services:
  postgis:
    image: your-image-name
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_DB: mydb
    volumes:
      - ./setup-additional.sh:/setup-additional.sh
    ports:
      - "5432:5432"
    restart: unless-stopped