PostgreSQL 高可用性 (HA) テンプレート Patroni: Etcd / Consul で自動フェイルオーバーを実現

Patroni

Patroniは、PostgreSQLに高可用性 (HA) を提供するオープンソースのテンプレートです。Etcd、Consul、ZooKeeper、Kubernetes といった分散コーディネーションサービス (DCS) と連携し、PostgreSQL クラスタのリーダー選出・自動フェイルオーバー・レプリケーション管理を自動化します。これにより、マスターノードの障害時にもサービスを継続的に提供することが可能になります。

基本情報

OSS 名Patroni
リポジトリgithub.com/patroni/patroni
スター数8.8k (2026-10 時点)
フォーク数1.0k (2026-10 時点)
ライセンスMIT
主な用途PostgreSQL の高可用性 / 自動フェイルオーバー
カテゴリデータベース / HA / PostgreSQL

アーキテクチャ

Patroni Architecture

主な機能

Patroniの主な機能は以下の通りです:

  • 自動フェイルオーバー: 分散コーディネーションサービス (DCS) を用いたリーダー選出により、マスターノードの障害時に自動で新しいリーダーを昇格させます。
  • レプリケーション管理: 同期・非同期レプリケーションの設定と制御を自動化し、データの一貫性を保ちます。
  • DCS 連携: Etcd、Consul、ZooKeeper、Kubernetes といった複数の分散コーディネーションサービスをサポートします。
  • REST API: クラスタ状態の取得や手動フェイルオーバーなどの操作を REST API 経由で実行できます。
  • Kubernetes 統合: StatefulSet や Operator と組み合わせることで、Kubernetes 上での PostgreSQL HA クラスタ構築が容易になります。

PatroniはHAProxyやPgBouncerといったコネクションプーラ・ロードバランサと組み合わせて利用されることが多く、クライアントに対して透過的な接続エンドポイントを提供できます。また、Zalando社をはじめとする多くの企業で本番環境に採用されています。

PatroniのGithubリポジトリは以下のURLにあります:https://github.com/patroni/patroni

Patroniを利用することで、PostgreSQLクラスタの高可用性運用を自動化し、障害時のダウンタイムを最小化することができます。手動でのフェイルオーバー作業や複雑なレプリケーション管理から解放され、信頼性の高いデータベース基盤を構築することが可能です。

Patroniの利用例

Patroniは、PostgreSQLクラスタの高可用性運用を自動化するオープンソースのテンプレートです。以下に、Patroniの利用例として、どのようなソフトウェアアーキテクチャで利用されているか、そしてなぜそのソフトウェアアーキテクチャで利用するのかについて詳細に説明します。

利用例

例えば、ある企業がミッションクリティカルなWebサービスやSaaSを運用している場合、データベース層のダウンタイムは直接的な売上損失やユーザー離脱につながります。このような場合、PostgreSQL のマスターノード障害時に手動対応を待つことなく、自動的にスタンバイノードを昇格させてサービスを継続する必要があります。Patroniは、このような状況において分散コーディネーションサービスと連携して自動フェイルオーバーを実現できるため、SLA/SLOの達成を重視する企業にとって非常に有用です。

ソフトウェアアーキテクチャでの利用

Patroniは、PostgreSQLの標準レプリケーション機能を基盤とした HA テンプレートです。各PostgreSQLノード上にPatroniエージェントを配置し、Etcd/Consul/ZooKeeperといったDCSを介してクラスタ全体の状態を共有・リーダー選出を行います。そのため、オンプレミスのベアメタル環境、仮想化基盤、Kubernetes上のStatefulSetなど、幅広いインフラ構成での利用が適しています。

利用目的

ミッションクリティカルなシステムを運用する企業は、データベース層のダウンタイムを最小化することが非常に重要です。Patroniを利用することで、マスター障害を自動検知し、数秒〜数十秒でスタンバイをプロモートすることが可能となります。これにより、サービスの可用性を維持しつつ、オペレーターの手動対応負荷を大幅に軽減することができます。

Patroniのソースコードには以下の主要なコンポーネントが含まれています。

  1. Patroni Agent:

    • 各PostgreSQLノード上で動作するエージェントプロセスのコードが含まれています。PostgreSQLのプロセス管理、ヘルスチェック、リーダー選出への参加、設定の反映などを担当します。
  2. DCS Adapter:

    • Etcd、Consul、ZooKeeper、Kubernetes、Exhibitorなど複数の分散コーディネーションサービスへの接続・操作を抽象化するアダプタ層のコードが含まれています。環境に応じたDCSの切り替えが容易に行えます。
  3. REST API:

    • クラスタの状態取得、手動フェイルオーバー、設定変更などを外部から操作するためのREST APIサーバーのコードが含まれています。HAProxyのヘルスチェックエンドポイントとしても利用されます。
  4. Bootstrap / Replication:

    • 新規クラスタの初期化、スタンバイノードのベースバックアップ取得、ストリーミングレプリケーション設定などを自動化するコードが含まれています。pg_basebackupやWAL-G/pgBackRestとの連携もサポートされます。
  5. Watchdog:

    • フェンシングを目的としたウォッチドッグ連携のコードが含まれています。スプリットブレイン回避のため、リーダーロスト時にノードを強制的に再起動させる仕組みを提供します。

これらのコンポーネントは、Patroniプロジェクトの主要な機能を実現するために必要な役割を分担しています。それぞれが疎結合に設計されており、環境に応じた柔軟な構成が可能です。Patroniのソースコードは、https://github.com/patroni/patroni で公開されているので、興味がある方は詳細を確認してみてください。