Новости
Обновление услуги LLM: управление API-ключами, моделями и расходами
DF
октября 28, 2025
Обновлено ноября 6, 2025

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

PostgreSQL

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

Patroni im age

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

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

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

  • Primary (master) - основной сервер PostgreSQL, принимающий запросы на запись.
  • Replica (standby) - реплика(и), получающие данные через потоковую репликацию.
  • DCS (Distributed Configuration Store) - внешнее хранилище конфигурации и состояния кластера (например, Etcd, Consul или ZooKeeper).
  • Patroni-агенты - процессы, запущенные на каждом узле, которые управляют PostgreSQL и координируют работу через DCS.

Каждый узел в кластере имеет своего 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 поддерживает 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 можно установить через пакетный менеджер или из исходников:

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

  • Мониторить живучесть нод - каждая реплика регулярно сообщает своё состояние в DCS (Distributed Configuration Store);
  • Выбирать лидера - в случае сбоя мастер-ноды система автоматически назначает новую без вмешательства администратора;
  • Обновлять конфигурацию кластера без даунтайма - изменения применяются динамически через REST API Patroni;
  • Интегрировать с системами оркестрации - например, Kubernetes-оператор Patroni позволяет запускать отказоустойчивый PostgreSQL в контейнерных окружениях;
  • Гибко настраивать уровень синхронизации реплик - выбирая между synchronous_mode и asynchronous_mode в зависимости от SLA по данным.

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

  1. Развернуть минимум три ноды PostgreSQL и три узла DCS (например, Etcd);
  2. Настроить HAProxy или PgBouncer для маршрутизации клиентских соединений;
  3. Реализовать регулярные тесты фейловера и резервное копирование WAL-файлов;
  4. Вести мониторинг через 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.
Оценка:
5 из 5
Аverage rating : 5
Оценок: 1
191028 Санкт-Петербург Литейный пр., д. 26, Лит. А
+7 (812) 403-06-99
700 300
ООО «ИТГЛОБАЛКОМ ЛАБС»
700 300

Вам также может быть интересно...