☰
06.11.2025

Что такое кластер Patroni и как он работает?

Patroni — это система управления высокодоступным кластером PostgreSQL, разработанная для автоматизации фейловера, репликации и поддержания консистентности между узлами базы данных.
Изначально Patroni создавался в компании Zalando и сейчас является одним из самых популярных решений для построения отказоустойчивых кластеров PostgreSQL.

Patroni обеспечивает автоматическое переключение ролей (primary/replica), контролирует здоровье узлов и позволяет поддерживать кластер PostgreSQL в рабочем состоянии без ручного вмешательства администратора.

Как устроен кластер Patroni

Кластер Patroni состоит из нескольких компонентов, которые взаимодействуют между собой:

Каждый узел в кластере имеет своего Patroni-демона, который:

  1. Отслеживает состояние PostgreSQL.
  2. Запрашивает информацию у DCS о текущем лидере (primary).
  3. Может принять роль primary, если текущий основной сервер стал недоступен.
Запустите проект за минуты с VPS в России — предустановленное ПО, высокая производительность и надёжная инфраструктура Serverspace - Арендовать VPS

Принцип работы Patroni

Работа Patroni основана на идее лидер-выбора (leader election) через DCS.

  1. Один из узлов получает "лидерство" - становится primary.
  2. Остальные узлы синхронизируют данные с primary через встроенную репликацию PostgreSQL.
  3. Если лидер выходит из строя (например, сервер недоступен или база не отвечает), Patroni выполняет автоматический фейловер:
    • Новый лидер выбирается из доступных реплик.
    • Кластер обновляет информацию в DCS.
    • Приложения перенаправляют запросы на новый primary (через HAProxy, PgBouncer или другое промежуточное ПО).

Таким образом, Patroni обеспечивает минимальное время простоя и непрерывную доступность базы данных.

Особенности и преимущества Patroni

Пример топологии Patroni

Простейшая схема Patroni-кластера может выглядеть так:

+------------------+
| HAProxy |
| (balancer) |
+--------+---------+
|
+---------+---------+
| |
+------+-----+ +-------+------+
| PostgreSQL | | PostgreSQL |
| (Primary) | | (Replica) |
+------+-----+ +-------+------+
| |
+----+----+ +----+----+
| Patroni | | Patroni |
+----+----+ +----+----+
| |
+---------+---------+
|
+------+------+
| Etcd / |
| Consul |
+-------------+

Настройка и запуск Patroni

Patroni можно установить через пакетный менеджер или из исходников:

pip install patroni[etcd]

Минимальный пример конфигурации (/etc/patroni.yml):

scope: postgres
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). Это позволяет:

Для повышения отказоустойчивости в продакшне рекомендуется:

  1. Развернуть минимум три ноды PostgreSQL и три узла DCS (например, Etcd);
  2. Настроить HAProxy или PgBouncer для маршрутизации клиентских соединений;
  3. Реализовать регулярные тесты фейловера и резервное копирование WAL-файлов;
  4. Вести мониторинг через Prometheus Exporter, доступный в составе Patroni.

Patroni хорошо сочетается с инструментами вроде pgBackRest, Grafana, Ansible и Kubernetes, образуя надёжную основу для современных облачных инфраструктур.

FAQ