Patroni — это система управления высокодоступным кластером PostgreSQL, разработанная для автоматизации фейловера, репликации и поддержания консистентности между узлами базы данных.
Изначально Patroni создавался в компании Zalando и сейчас является одним из самых популярных решений для построения отказоустойчивых кластеров PostgreSQL.
Patroni обеспечивает автоматическое переключение ролей (primary/replica), контролирует здоровье узлов и позволяет поддерживать кластер PostgreSQL в рабочем состоянии без ручного вмешательства администратора.
Как устроен кластер Patroni
Кластер Patroni состоит из нескольких компонентов, которые взаимодействуют между собой:
- Primary (master) - основной сервер PostgreSQL, принимающий запросы на запись.
- Replica (standby) - реплика(и), получающие данные через потоковую репликацию.
- DCS (Distributed Configuration Store) - внешнее хранилище конфигурации и состояния кластера (например, Etcd, Consul или ZooKeeper).
- Patroni-агенты - процессы, запущенные на каждом узле, которые управляют PostgreSQL и координируют работу через DCS.
Каждый узел в кластере имеет своего Patroni-демона, который:
- Отслеживает состояние PostgreSQL.
- Запрашивает информацию у DCS о текущем лидере (primary).
- Может принять роль primary, если текущий основной сервер стал недоступен.
Принцип работы Patroni
Работа Patroni основана на идее лидер-выбора (leader election) через DCS.
- Один из узлов получает "лидерство" - становится primary.
- Остальные узлы синхронизируют данные с primary через встроенную репликацию PostgreSQL.
- Если лидер выходит из строя (например, сервер недоступен или база не отвечает), Patroni выполняет автоматический фейловер:
- Новый лидер выбирается из доступных реплик.
- Кластер обновляет информацию в DCS.
- Приложения перенаправляют запросы на новый primary (через HAProxy, PgBouncer или другое промежуточное ПО).
Таким образом, Patroni обеспечивает минимальное время простоя и непрерывную доступность базы данных.
Особенности и преимущества Patroni
- Автоматический фейловер
Переключение между узлами происходит автоматически при сбое без вмешательства администратора. - Интеграция с внешними системами
Patroni поддерживает DCS (Etcd, Consul, ZooKeeper) для координации состояния кластера. - Гибкая настройка репликации
Можно использовать как синхронную, так и асинхронную репликацию PostgreSQL. - REST API
Каждый узел предоставляет API для управления, мониторинга и интеграции с внешними инструментами. - Поддержка внешних балансировщиков
Patroni легко интегрируется с HAProxy или PgBouncer для маршрутизации клиентских подключений к текущему primary.
Пример топологии Patroni
Простейшая схема Patroni-кластера может выглядеть так:
| HAProxy |
| (balancer) |
+--------+---------+
|
+---------+---------+
| |
+------+-----+ +-------+------+
| PostgreSQL | | PostgreSQL |
| (Primary) | | (Replica) |
+------+-----+ +-------+------+
| |
+----+----+ +----+----+
| Patroni | | Patroni |
+----+----+ +----+----+
| |
+---------+---------+
|
+------+------+
| Etcd / |
| Consul |
+-------------+
Настройка и запуск Patroni
Patroni можно установить через пакетный менеджер или из исходников:
Минимальный пример конфигурации (/etc/patroni.yml):
name: node1
restapi:
listen: 0.0.0.0:8008
connect_address: 192.168.1.10:8008
etcd:
host: 192.168.1.100:2379
postgresql:
listen: 0.0.0.0:5432
connect_address: 192.168.1.10:5432
data_dir: /var/lib/postgresql/data
authentication:
replication:
username: repl
password: repl_pass
superuser:
username: postgres
password: admin_pass
parameters:
max_connections: 100
shared_buffers: 256MB
После настройки всех узлов и запуска Patroni процесс координации и репликации произойдёт автоматически.
Заключение: практические советы
Patroni - это не просто надстройка над PostgreSQL, а полноценная система управления жизненным циклом кластера. Она сочетает в себе возможности репликации, автоматического фейловера и динамической конфигурации, что делает её незаменимой в продакшн-средах, где недопустимы простои базы данных.
С технической точки зрения, Patroni действует как «координатор» между нодами PostgreSQL, синхронизируя состояние через распределённое хранилище (Etcd, Consul или ZooKeeper). Это позволяет:
- Мониторить живучесть нод - каждая реплика регулярно сообщает своё состояние в DCS (Distributed Configuration Store);
- Выбирать лидера - в случае сбоя мастер-ноды система автоматически назначает новую без вмешательства администратора;
- Обновлять конфигурацию кластера без даунтайма - изменения применяются динамически через REST API Patroni;
- Интегрировать с системами оркестрации - например, Kubernetes-оператор Patroni позволяет запускать отказоустойчивый PostgreSQL в контейнерных окружениях;
- Гибко настраивать уровень синхронизации реплик - выбирая между synchronous_mode и asynchronous_mode в зависимости от SLA по данным.
Для повышения отказоустойчивости в продакшне рекомендуется:
- Развернуть минимум три ноды PostgreSQL и три узла DCS (например, Etcd);
- Настроить HAProxy или PgBouncer для маршрутизации клиентских соединений;
- Реализовать регулярные тесты фейловера и резервное копирование WAL-файлов;
- Вести мониторинг через Prometheus Exporter, доступный в составе Patroni.
Patroni хорошо сочетается с инструментами вроде pgBackRest, Grafana, Ansible и Kubernetes, образуя надёжную основу для современных облачных инфраструктур.
FAQ
- Можно ли использовать Patroni без Etcd или Consul?
Нет. Patroni требует DCS (например, Etcd, ZooKeeper или Consul) для хранения метаданных и выборов лидера. - Нужен ли отдельный сервер для DCS?
Да, DCS должен быть развернут независимо от узлов PostgreSQL, чтобы избежать единой точки отказа. - Поддерживает ли Patroni синхронную репликацию?
Да, можно указать синхронные реплики в настройках synchronous_mode: true. - Как мониторить кластер?
Через REST API (/patroni) или сторонние инструменты вроде Prometheus + Grafana. - Можно ли развернуть Patroni в Docker?
Да, официально поддерживаются контейнерные окружения — есть готовые образы и Helm Chart для Kubernetes.