galetahub/patroni
galetahub
通过Patroni在Docker上实现的高可用PostgreSQL集群，支持自动故障转移，基于Docker Swarm编排，集成haproxy、etcd、pgbouncer和wal-g等组件。
下载次数: 0状态：社区镜像维护者：galetahub仓库类型：镜像最近更新：7 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Docker上的高可用PostgreSQL集群
概述和主要用途
这是一个Docker Compose文件和辅助脚本，用于演示如何使用Docker Swarm部署具有自动故障转移功能的高可用PostgreSQL集群。该集群集成了PostgreSQL数据库、连接池(pgbouncer)、集群管理(patroni)、备份工具(wal-g)、分布式配置存储(etcd)和负载均衡(haproxy)，提供稳定可靠的数据库服务。
核心功能和技术栈
完整技术栈包括：
- Docker Swarm模式：用于容器编排和管理
- HAProxy：提供数据库读写端点的负载均衡
- etcd：分布式配置存储和 leader 选举
- Patroni：管理数据库复制和高可用（https://github.com/zalando/patroni%EF%BC%89
- PostgreSQL：关系型数据库（https://www.postgresql.org/%EF%BC%89
- PgBouncer：数据库连接池（https://github.com/pgbouncer/pgbouncer%EF%BC%89
- WAL-G：PostgreSQL备份工具（https://github.com/wal-g/wal-g%EF%BC%89
配置说明
Patroni环境变量
| 名称 | 描述 | 默认值 |
|---|---|---|
PATRONI_SCOPE | Patroni集群名称/作用域 | batman |
PATRONI_NAME | Patroni节点名称 | $(hostname) |
PATRONI_POSTGRESQL_DATA_DIR | PostgreSQL数据目录 | $PGDATA |
PATRONI_POSTGRESQL_LISTEN | PostgreSQL监听地址 | 0.0.0.0:5432 |
PATRONI_POSTGRESQL_CONNECT_ADDRESS | PostgreSQL连接地址 | $DOCKER_IP:5432 |
PATRONI_RESTAPI_LISTEN | Patroni REST API监听地址 | 0.0.0.0:8008 |
PATRONI_RESTAPI_CONNECT_ADDRESS | Patroni REST API连接地址 | $DOCKER_IP:8008 |
PATRONI_REPLICATION_USERNAME | 复制用户名 | replicator |
PATRONI_POSTGRESQL_PGPASS | .pgpass文件路径 | /opt/postgres/.pgpass |
PATRONI_CONFIG_PATH | Patroni配置文件路径 | /opt/postgres/config/postgres.yml |
PostgreSQL环境变量
| 名称 | 描述 | 默认值 |
|---|---|---|
PG_SHARED_BUFFERS | 共享缓冲区内存大小 | 2GB |
PG_EFFECTIVE_CACHE_SIZE | 规划器对内核缓存大小的假设 | 6GB |
PG_MAINTENANCE_WORK_MEM | 维护操作内存大小 | 512MB |
PG_CHECKPOINT_COMPLETION_TARGET | 检查点完成目标 | 0.7 |
PG_WAL_BUFFERS | WAL缓冲区内存大小 | 16MB |
PG_DEFAULT_STATISTICS_TARGET | 列的默认统计目标 | 100 |
PG_RANDOM_PAGE_COST | 非顺序获取磁盘页的成本 | 1.1 |
PG_EFFECTIVE_IO_CONCURRENCY | 并发磁盘I/O操作数 | 200 |
PG_WORK_MEM | 查询操作内存大小 | 16MB |
PG_MIN_WAL_SIZE | WAL最小收缩大小 | 1GB |
PG_MAX_WAL_SIZE | WAL最大增长大小 | 4GB |
PG_MAX_WORKER_PROCESSES | 最大后台进程数 | 2 |
PG_MAX_PARALLEL_WORKERS_PER_GATHER | 每个gather节点的最大并行工作线程数 | 1 |
PG_MAX_PARALLEL_WORKERS | 最大并行工作线程数 | 2 |
PG_UNIX_SOCKET_DIRECTORIES | Unix socket目录 | /tmp |
PG_MAX_CONNECTIONS | 最大并发连接数 | 64 |
可根据硬件配置计算PostgreSQL优化配置：[***]
通知环境变量
| 名称 | 描述 | 默认值 |
|---|---|---|
TELEGRAM_API_TOKEN | 用于发送通知的***机器人API令牌 | - |
TELEGRAM_CHAT_ID | 接收通知的***聊天ID | - |
使用场景和适用范围
适用于需要高可用PostgreSQL数据库的生产环境，如企业级应用、数据服务、电商平台等对数据库可靠性要求较高的场景。通过Docker Swarm编排，可简化部署和管理流程，确保数据库服务持续可用。
使用方法
- 确保已安装Docker和Docker Compose，并启用Docker Swarm模式
- 获取项目文件（包括docker-compose.yml和辅助脚本）
- 根据需求配置环境变量（如Patroni、PostgreSQL参数及通知设置）
- 使用Docker Compose部署集群：
docker-compose up -d - 监控集群状态，可通过Patroni REST API或etcd查看节点信息
更多信息：https://github.com/galetahub/patroni-docker-image
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull galetahub/patroni:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"