sysnetcz/postgis

POSTGIS CS

镜像概述和主要用途

这是一个运行PostGIS的Docker容器，基于https://hub.docker.com/r/kartoza/postgis/%E4%BF%AE%E6%94%B9%EF%BC%8C%E5%B0%86%E9%BB%98%E8%AE%A4%E5%8C%BA%E5%9F%9F%E8%AE%BE%E7%BD%AE%E6%9B%B4%E6%94%B9%E4%B8%BA%60cs_CZ.UTF-8%60%E3%80%82%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E6%8D%B7%E5%85%8B%E8%AF%AD%E7%BC%96%E7%A0%81%E5%92%8C%E6%8E%92%E5%BA%8F%E8%A7%84%E5%88%99%E7%9A%84PostGIS%E5%BA%94%E7%94%A8%E5%9C%BA%E6%99%AF%E3%80%82

Docker Hub页面：https://hub.docker.com/r/sysnetcz/postgis/

注意：如果不需要捷克编码和排序规则，请使用原始的kartoza/postgis镜像。

对于PostGIS、Docker和QGIS的初学者，推荐参考Alex Urquhart的教程：[***]

核心功能和特性

• 基于官方PostGIS镜像，默认区域设置为cs_CZ.UTF-8
• 支持PostgreSQL和PostGIS版本标签化，便于版本控制
• 可通过环境变量配置数据库用户、密码、默认数据库及扩展
• 支持数据库持久化存储
• 提供主从复制功能，实现数据库同步和故障转移

标签版本说明

镜像标签遵循以下命名规则：

sysnetcz/postgis:[postgres_version]-[postgis-version]

例如：sysnetcz/postgis:9.6-2.4表示包含PostgreSQL 9.6和PostGIS 2.4。

重要：强烈建议使用标签版本，因为PostgreSQL的不同小版本会将数据库集群写入不同的目录，若使用持久卷存储数据库，使用非标签版本可能导致数据库数据无法识别。

获取镜像

拉取Docker Trusted Build（推荐）

bash
docker pull sysnetcz/postgis

不使用apt-cacher构建

bash
docker build -t sysnetcz/postgis git://github.com/SYSNET-CZ/postgis

使用apt-cacher构建（减少带宽消耗）

1. 克隆仓库：

bash
git clone git://github.com/SYSNET-CZ/postgis

2. 编辑71-apt-cacher-ng文件，配置apt-cacher主机
3. 构建镜像：

bash
docker build -t sysnetcz/postgis .

使用方法

基本运行

bash
sudo docker run --name "postgis" -p 25432:5432 -d -t sysnetcz/postgis

环境变量配置

可通过以下环境变量自定义数据库配置：

docker-compose配置

提供便捷的docker-compose.yml，包含数据库和备份服务（基于https://github.com/kartoza/docker-pg-backup%EF%BC%89%E3%80%82%E6%9A%B4%E9%9C%B2PostgreSQL%E7%AB%AF%E5%8F%A325432%E4%BB%A5%E9%81%BF%E5%85%8D%E4%B8%8E%E6%9C%AC%E5%9C%B0%E6%95%B0%E6%8D%AE%E5%BA%93%E5%86%B2%E7%AA%81%E3%80%82

使用示例：

bash
docker-compose up -d

注意：默认配置下数据仅存储在Docker卷中，不会持久化到主机磁盘。

通过psql连接

1. 安装PostgreSQL客户端（以Ubuntu 16.04为例）：

bash
sudo apt-get install postgresql-client-9.6

2. 连接数据库：

bash
psql -h localhost -U docker -p 25432 -l

默认凭据：用户docker，密码docker

主机数据持久化

使用Docker卷将数据存储在主机上：

bash
mkdir -p ~/postgres_data
docker run -d -v $HOME/postgres_data:/var/lib/postgresql sysnetcz/postgis

权限说明：确保postgres_data目录具有Docker进程可读写的权限。

Postgres主从复制配置

复制功能允许维护多个同步的数据库副本，包含一个主节点（可写）和一个或多个从节点（只读）。主节点的变更会自动同步到从节点。

环境变量配置

主节点设置

• ALLOW_IP_RANGE：允许连接的IP范围，需包含从节点地址
• POSTGRES_USER和POSTGRES_PASS：从节点连接主节点的凭据，建议设置为安全值

从节点设置

• REPLICATE_FROM：主节点的域名或IP地址
• REPLICATE_PORT：主节点PostgreSQL端口，默认5432
• DESTROY_DATABASE_ON_RESTART：重启时是否销毁数据库，默认True，设为False可保留数据
• PROMOTE_MASTER：设为任意值可将从节点提升为主节点（提升后无法恢复为从节点）

复制示例运行步骤

1. 执行build.sh脚本构建镜像：

bash
./build.sh

2. 进入sample/replication目录，使用Make命令启动服务：

bash
make up

3. 关闭服务：

bash
make down

4. 查看日志：

bash
make master-log  # 主节点日志
make slave-log   # 从节点日志

复制场景测试

主节点变更同步到从节点

1. 进入主节点shell：

bash
make master-shell

2. 使用psql进行数据库变更
3. 进入从节点shell查看同步结果：

bash
make slave-shell

从节点提升为主节点

1. 配置从节点环境变量：

PROMOTE_MASTER: 'True'
DESTROY_DATABASE_ON_RESTART: 'False'

2. 重启从节点后即可作为主节点写入数据（此时与原主节点不再同步）

防止从节点重启时数据销毁

设置DESTROY_DATABASE_ON_RESTART: 'False'，并确保数据卷已持久化，从节点重启后可继续同步（无一致性冲突时）。

credits

Radim Jaeger (***)