mmartinello/patroni

PostgreSQL、pg_cron、PostGIS、pgRouting与Patroni Docker镜像

镜像概述和主要用途

本Docker镜像基于Debian 12 Bookworm构建，集成了PostgreSQL数据库及其多个扩展，包括Patroni（高可用解决方案）、pg_cron（定时任务调度器）、PostGIS（地理数据支持）、pgRouting（地理路由功能）和pgBackRest（备份恢复工具）。适用于需要高可用、地理空间数据处理及定时任务管理的PostgreSQL数据库场景。

核心功能和特性

• PostgreSQL：开源关系型数据库，强调可扩展性和SQL兼容性。
• Patroni：基于Python的PostgreSQL高可用模板，支持etcd分布式配置存储。
• pgBackRest：可靠的PostgreSQL备份恢复解决方案，支持大规模数据库。
• pg_cron：PostgreSQL的cron风格定时任务调度器。
• PostGIS：扩展PostgreSQL以支持地理数据的存储、索引和查询。
• pgRouting：基于PostGIS/PostgreSQL提供地理空间路由功能。
• 多版本支持：可安装额外PostgreSQL主版本（用于升级场景）。
• 本地化支持：可安装额外 locales（满足特定数据库排序需求）。

标签说明

标签格式：<patroni_version>-pg<pg_major_version>-<image_variant>

镜像变体（安装的扩展）

• pgcron：仅包含pg_cron
• pgcron-postgis：包含pg_cron和PostGIS
• pgcron-pgrouting：包含pg_cron和pgRouting
• postgis：仅包含PostGIS
• postgis-pgrouting：包含PostGIS和pgRouting
• pgrouting：仅包含pgRouting

所有变体均默认安装PostgreSQL、Patroni和pgBackRest。未指定变体时，安装所有扩展。

卷（Volumes）

需配置或挂载以下卷以确保数据持久化：

• /var/log/patroni：Patroni日志目录
• /var/lib/postgresql：PostgreSQL数据目录
• /etc/patroni.yml：Patroni本地配置文件

端口

镜像监听以下端口：

• PostgreSQL端口：默认5432
• Patroni REST API端口：默认8008

配置说明

Patroni支持多种配置方式：全局动态配置、本地配置文件或环境变量，可单独或组合使用。详细配置方法参见https://patroni.readthedocs.io/en/latest/patroni_configuration.html%E3%80%82

构建指南

构建参数（环境变量）

• PG_MAJOR：PostgreSQL主版本（默认14）
• INSTALL_PG_CRON：是否安装pg_cron（true安装，默认false）
• INSTALL_POSTGIS：是否安装PostGIS（true安装，默认false）
• INSTALL_PGROUTING：是否安装pgRouting（true安装，默认false）
• ADDITIONAL_PG_MAJORS：额外安装的PostgreSQL主版本（空格分隔多个版本）
• ADDITIONAL_LOCALES：额外安装的locales（空格分隔多个locale）

安装额外PostgreSQL版本

通过ADDITIONAL_PG_MAJORS参数可安装多个PostgreSQL主版本，适用于使用pg_upgrade进行版本升级的场景（需旧版本二进制文件）。

示例：构建包含PostgreSQL 16（主版本）及12、13（额外版本）的镜像

bash
docker build --build-arg PG_MAJOR=16 --build-arg ADDITIONAL_PG_MAJORS="12 13" -t my-postgres-patroni-image .

构建命令

基础构建：

bash
docker build -t <image_tag> .

带参数构建示例（不安装pg_cron）：

bash
docker build --build-arg='INSTALL_PG_CRON=false' -t <image_tag> .

维护者

Mattia Martinello