Docs

Docs

Patroni는 PostgreSQL에 없는 자동 failover를 채워 주는 고가용성 프레임워크입니다. 각 노드에서 데몬으로 돌면서 DCS(Distributed Configuration Store)를 통해 leader를 선출하고, 장애가 나면 replica를 자동으로 승격합니다. 이 노트는 Patroni 4.1.4 공식 문서와 GitHub 저장소를 바탕으로, 분산 시스템 개념이 익숙하지 않은 DBA도 동작 원리부터 운영까지 따라올 수 있도록 정리했습니다.

왼쪽 사이드바에서 챕터를 선택해 읽거나, 아래 차례에서 원하는 Part로 들어가세요. 처음이라면 Part I → II → VI 순서를 권합니다.

차례

Part I. 시작하기

Patroni란·고가용성 문제·역사·5분 Quickstart

Part II. 아키텍처

HA 루프·leader lock·DCS 키·split brain·failsafe

Part III. DCS 백엔드

etcd·Consul·ZooKeeper·Kubernetes

Part IV. 설치와 구성

patroni.yml·구성 3계층·PostgreSQL 파라미터 관리

Part V. 클러스터 부트스트랩

initdb·기존 클러스터 인수·replica 생성·slot 관리

Part VI. Failover와 Switchover

leader race·후보 선정·synchronous mode·pg_rewind

Part VII. patronictl

상태 조회·구성 변경·전환 명령·pause

Part VIII. REST API

health check·조회·쓰기 연산·보안

Part IX. 연결 라우팅

HAProxy·vip-manager·클라이언트 라우팅·callbacks

Part X. 운영 시나리오

업그레이드·노드 증설·standby cluster·백업 통합

Part XI. 모니터링과 트러블슈팅

로그·metrics·경보·흔한 장애 시나리오

Part XII. 심화

tags·Kubernetes·Citus·보안 강화

표기 규약

본문 산문은 PostgreSQL·Patroni 풀네임
별도 명시가 없으면 Patroni 4.1.4 기준
고가용성·PostgreSQL 고유 용어(failover, switchover, primary, replica, leader, DCS, WAL, replication slot, watchdog, quorum 등)는 번역하지 않고 영문 그대로
설정(patroni.yml)·명령(patronictl)·REST 엔드포인트는 그대로 복사해 쓸 수 있는 형태로
모든 도식은 Mermaid
공식 문서 원문: https://patroni.readthedocs.io/en/latest/

차례

표기 규약

관련 사이트