metocean/postgis

docker-postgis-consul 镜像文档

镜像概述

docker-postgis-consul是一个集成了PostgreSQL 9.5数据库、PostGIS 2.2空间扩展以及Consul 0.7.0服务发现工具的Docker镜像。该镜像旨在提供一站式的空间数据存储、处理能力与服务注册发现功能，简化包含空间数据和分布式服务架构的应用部署流程。

核心功能与特性

1. PostgreSQL 9.5

• 提供稳定的关系型数据库功能，支持标准SQL查询
• 支持事务处理、数据完整性约束及并发控制
• 可配置的性能优化参数

2. PostGIS 2.2

• 扩展PostgreSQL以支持地理空间数据类型（如点、线、面等）
• 提供空间索引功能，优化地理数据查询性能
• 支持空间分析函数（如距离计算、面积计算、缓冲区分析等）
• 兼容OGC（开放地理空间联盟）标准

3. Consul 0.7.0

• 服务注册与发现：自动注册PostgreSQL服务，支持服务健康检查
• 分布式配置管理：可集中管理数据库配置参数
• 多数据中心支持：适用于跨区域部署场景
• 内置DNS服务：通过域名访问注册的服务

使用场景与适用范围

• GIS应用开发：需要存储和处理地理空间数据的应用，如地图服务、位置分析系统
• 分布式系统：需要服务发现功能的微服务架构，简化服务间通信配置
• 开发测试环境：快速搭建包含空间数据库和服务发现的本地开发环境
• 中小型项目：需要简化基础设施部署的场景，减少多组件集成复杂度

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  --name postgis-consul \
  -p 5432:5432 \  # PostgreSQL端口
  -p 8500:8500 \  # Consul Web UI端口
  -e POSTGRES_PASSWORD=mysecretpassword \  # PostgreSQL密码
  -e CONSUL_CLIENT_ADDR=0.0.0.0 \  # Consul客户端绑定地址
  docker-postgis-consul

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  postgis-consul:
    image: docker-postgis-consul
    container_name: postgis-consul
    ports:
      - "5432:5432"
      - "8500:8500"
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: gisuser
      POSTGRES_DB: gisdb
      CONSUL_CLIENT_ADDR: 0.0.0.0
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - consul_data:/consul/data
    restart: unless-stopped

volumes:
  postgres_data:
  consul_data:

验证部署

1. 访问PostgreSQL：

   bash
   psql -h localhost -p 5432 -U postgres -d postgres
   

   输入密码后，执行SELECT PostGIS_version();验证PostGIS是否安装成功。

2. 访问Consul UI： 打开浏览器访问 http://localhost:8500，在服务列表中可查看注册的PostgreSQL服务。

注意事项

• 生产环境中建议通过Docker volumes持久化PostgreSQL数据和Consul数据
• 根据实际需求调整资源限制（如内存、CPU）
• 若需集群部署Consul，需额外配置Consul的server模式和集群参数
• 定期备份PostgreSQL数据，避免数据丢失