PostgreSQL 의 HA (High Availability) 를 지원하는 Open Source
자동 장애를 감지하여 자동으로 Failover 지원 및 Replication 관리 등을 제공하여 서비스 중단을 최소화
maximum_lag_on_failover 기준에 따라 Failover 여부를 결정
PostgreSQL cluster를 쉽고 유연하게 구축을 지원하며, Python 기반
자체적으로 Leader 를 선출(promotion)하는데, 이때 Distributed Configuration Store(다양한 분산 설정 저장소-ZooKeeper, etcd, Consul, Kubernetes 등)를 활용하여 Cluster leader(primary) 를 선출
주로 Cluster status, Leader Info 등의 정보를 저장하는 용도이며, 모든 node가 해당 정보를 공유
RAFT 합의 알고리즘을 사용(대부분 election 관련한 것은 RAFT 알고리즘을 사용하는 듯 - MongoDB...)
PostgreSQL 인스턴스 startup / stop / restart 를 직접 관리하며, replication 생성을 위한 설정 변경 등도 자동으로 지원
Rest API를 제공하여 노드별 관리 및 상태 확인, 수동으로 장애조치(Manual Failover) 등을 지원
patronictl 명령어로 클러스터 상태 모니터링, switchover(수동 리더 전환), manual failover(강제 장애조치) 등 수행 가능
Cloud 환경 지원 (AWS, GCP, k8s)
설정 파일에 대해 실시간 적용
구성요소
역할
Patroni 인스턴스
각 서버(노드)에서 PostgreSQL 프로세스를 관리, 상태 체크, 리더 선출에 참여
분산 저장소(etcd 등)
클러스터 메타데이터, 리더 정보, 노드 상태 등 공유 역할
PostgreSQL 인스턴스
실질적인 데이터 저장 및 클라이언트 서비스 제공
Failover(장애조치) 동작 방식
상태 모니터링: 각 Patroni 인스턴스는 자신의 PostgreSQL과 외부 분산 저장소(etcd/Consul 등)을 통해 클러스터 전체 상태를 파악
각 Instance 에 존재하는 Patroni instance 들이 자신의 상태정보(정상 여부, LSN 동기화 등)를 주기적으로 etcd 에 등록
etcd 에 등록된 다른 노드들은, 이러한 정보들을 서로 계속 모니터링
Primary 장애 감지: Primary(PostgreSQL 리더) 인스턴스에 장애가 발생해 heartbeat/stats 갱신이 중지되면, 나머지 Replica Patroni 인스턴스들이 즉시 이를 감지.(Health check)
Primary(Leader) 선출(election): Patroni 인스턴스들이 협의하여 etcd 같은 분산 저장소를 통해 새로운 리더를 선출. 가장 최신의 WAL 로그를 가진 standby가 우선 승격 대상.
자동 승격(Promotion): 선출된 Replica는 자동으로 PostgreSQL primary로 승격(promote) 되고, 클러스터 상태가 분산 저장소에 반영
기존(Old) Primary restart : 장애가 복구된 이전 Primary는 자동으로 Replica로 강등(demote)되어 클러스터에 재합류(재동기화).
동적 재구성: 연결 관리(HAProxy, PgBouncer, 애플리케이션 등)는 REST API와 클러스터 메타 정보로 새로운 리더 정보를 즉시 인지.
DCS (분산 구성 저장소, Distributed Configuration Store) 역할
Cluster 상태 공유 및 Leader 선출
Cluster 내 모든 node(PostgreSQL + Patroni ) 의 DCS 에 접근하여 클러스터의 상태와 구성 정보를 저장하고 공유
Primary (Leader)의 경우 주기적으로 DCS에 자신의 상태(leader key, TTL 등)를 갱신하고, 다른 노드들이 이 정보를 지속적으로 체크하여, 혹시라도 갱신이 멈추면 key 를 만료시켜 Leader 선출 프로세스가 자동으로 시작
Node 상태 감지 및 Failover 지원
Patroni agent 가 자신의 상태 정보를 DCS 에 주기적으로 업데이트 하여 모든 노드가 서로의 상태를 감지할 수 있음
Split brain 방지
DCS 의 Leader lock 의 TTL 관리와 patroni 의 Self-fencing (자기 격리) 메커니즘을 통해, 네트워크 split 이나 시스템 장애시 여러 node 가 동시에 primary 로 오작동하는 문제를 예방
DCS와 connection 이 끊어지거나, Leader key 갱신이 실패하면, 해당 node 는 자신을 자동으로 replica 로 강등시켜 데이터 손실 및 충독을 예방
각종 관련된 확인 내용
#Patroni 클러스터 정보
root@QEMU-Virtual-Machine:/data# patronictl -c /etc/patroni1.yml list
+ Cluster: pg-cluster (7527206046275954701) ----+----+-----------+
| Member | Host | Role | State | TL | Lag in MB |
+--------+----------------+---------+-----------+----+-----------+
| node1 | 127.0.0.1:5432 | Leader | running | 1 | |
| node2 | 127.0.0.1:5433 | Replica | streaming | 1 | 0 |
| node3 | 127.0.0.1:5434 | Replica | streaming | 1 | 0 |
+--------+----------------+---------+-----------+----+-----------+
# DCS(etcd) 정보
root@QEMU-Virtual-Machine:/data# etcdctl member list
2c5b13349b914f7c, started, etcd2, http://127.0.0.1:2480, http://127.0.0.1:2479, false
d6b6fc75feb1ea61, started, etcd3, http://127.0.0.1:2580, http://127.0.0.1:2579, false
e17d9e661baad1bc, started, etcd1, http://127.0.0.1:2380, http://127.0.0.1:2379, false
#Leader / member 정보
root@QEMU-Virtual-Machine:/data# etcdctl endpoint status --cluster
http://127.0.0.1:2479, 2c5b13349b914f7c, 3.6.2, 3.6.0, 78 kB, 78 kB, 0%, 0 B, false, false, 2, 292, 292, , , false
http://127.0.0.1:2579, d6b6fc75feb1ea61, 3.6.2, 3.6.0, 78 kB, 78 kB, 0%, 0 B, false, false, 2, 292, 292, , , false
http://127.0.0.1:2379, e17d9e661baad1bc, 3.6.2, 3.6.0, 78 kB, 78 kB, 0%, 0 B, true, false, 2, 292, 292, , , false
#/service/{Cluster name} 경로에 Cluster 상태 정보 및 구성 값을 저장되어 확인이 가능
# 아래 내용은 모든 내용을 출력 / 해당 정보들이 꾸준히 갱신
root@QEMU-Virtual-Machine:/data# etcdctl get / --prefix
/service/pg-cluster/config
{"ttl":30,"loop_wait":10,"retry_timeout":10,"maximum_lag_on_failover":1048576,"postgresql":{"use_pg_rewind":true,"parameters":{"wal_level":"replica","hot_standby":"on","max_wal_senders":10,"max_replication_slots":10,"wal_keep_size":"512MB"}}}
/service/pg-cluster/initialize
7527206046275954701
/service/pg-cluster/leader
node1
/service/pg-cluster/members/node1
{"conn_url":"postgres://127.0.0.1:5432/postgres","api_url":"http://127.0.0.1:8008/patroni","state":"running","role":"primary","version":"4.0.4","xlog_location":150995304,"timeline":1}
/service/pg-cluster/members/node2
{"conn_url":"postgres://127.0.0.1:5433/postgres","api_url":"http://127.0.0.1:8018/patroni","state":"running","role":"replica","version":"4.0.4","xlog_location":150995304,"replication_state":"streaming","timeline":1}
/service/pg-cluster/members/node3
{"conn_url":"postgres://127.0.0.1:5434/postgres","api_url":"http://127.0.0.1:8028/patroni","state":"running","role":"replica","version":"4.0.4","xlog_location":150995304,"replication_state":"streaming","timeline":1}
/service/pg-cluster/status
{"optime":150995304,"slots":{"node2":150995304,"node3":150995304,"node1":150995304},"retain_slots":["node1","node2","node3"]}
/service/pgtest/config
{"ttl":30,"loop_wait":10,"retry_timeout":10,"maximum_lag_on_failover":1048576,"postgresql":{"use_pg_rewind":true,"use_slots":true,"parameters":{"wal_level":"replica","hot_standby":"on","wal_keep_size":"64MB","max_wal_senders":10,"max_replication_slots":10}}}
/service/pgtest/initialize
7527193237175963385
/service/pgtest/status
{"optime":67438232,"slots":{"node2":33554680,"node3":33554680,"node1":67438232},"retain_slots":["node1","node2","node3"]}
# leader 정보만 확인 /service/{cluster name}/leader
root@QEMU-Virtual-Machine:/data# etcdctl get /service/pg-cluster/leader
/service/pg-cluster/leader
node1
# Patroni 가 사용하는 관련 모든 정보 /service/{cluster name}
root@QEMU-Virtual-Machine:/data# etcdctl get /service/pg-cluster --prefix
/service/pg-cluster/config
{"ttl":30,"loop_wait":10,"retry_timeout":10,"maximum_lag_on_failover":1048576,"postgresql":{"use_pg_rewind":true,"parameters":{"wal_level":"replica","hot_standby":"on","max_wal_senders":10,"max_replication_slots":10,"wal_keep_size":"512MB"}}}
/service/pg-cluster/initialize
7527206046275954701
/service/pg-cluster/leader
node1
/service/pg-cluster/members/node1
{"conn_url":"postgres://127.0.0.1:5432/postgres","api_url":"http://127.0.0.1:8008/patroni","state":"running","role":"primary","version":"4.0.4","xlog_location":150995304,"timeline":1}
/service/pg-cluster/members/node2
{"conn_url":"postgres://127.0.0.1:5433/postgres","api_url":"http://127.0.0.1:8018/patroni","state":"running","role":"replica","version":"4.0.4","xlog_location":150995304,"replication_state":"streaming","timeline":1}
/service/pg-cluster/members/node3
{"conn_url":"postgres://127.0.0.1:5434/postgres","api_url":"http://127.0.0.1:8028/patroni","state":"running","role":"replica","version":"4.0.4","xlog_location":150995304,"replication_state":"streaming","timeline":1}
/service/pg-cluster/status
{"optime":150995304,"slots":{"node2":150995304,"node3":150995304,"node1":150995304},"retain_slots":["node1","node2","node3"]}
+------------------------+
| etcd Cluster | <-- 클러스터 상태 관리(leader key, member key)
+-----------+------------+
^
|
Patroni REST API (상태 저장/전파, leader 선출 등)
+-----------+------------+
| Patroni | <-- 각 PostgreSQL 노드에 설치
+-----------+------------+
|
PostgreSQL 인스턴스 (primary, standby)
#by. perplexity
ETCD_VER=v3.6.2
# choose either URL
GOOGLE_URL=https://storage.googleapis.com/etcd
DOWNLOAD_URL=${GOOGLE_URL}
rm -f /tmp/etcd-${ETCD_VER}-linux-arm64.tar.gz
rm -rf /tmp/etcd-download-test && mkdir -p /tmp/etcd-download-test
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-arm64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-arm64.tar.gz
tar xzvf /tmp/etcd-${ETCD_VER}-linux-arm64.tar.gz -C /tmp/etcd-download-test --strip-components=1 --no-same-owner
rm -f /tmp/etcd-${ETCD_VER}-linux-arm64.tar.gz
/tmp/etcd-download-test/etcd --version
/tmp/etcd-download-test/etcdctl version
/tmp/etcd-download-test/etcdutl version
# start a local etcd server
# screen 으로 띄우자
sudo cp etcd etcdctl etcdutl /usr/local/bin/
screen -S etcd
etcd -- 실행
# 로그가 실행되면, Screen 에서 빠져나오자.
# write,read to etcd test
/tmp/etcd-download-test/etcdctl --endpoints=localhost:2379 put foo bar
/tmp/etcd-download-test/etcdctl --endpoints=localhost:2379 get foo
# test2
> etcdctl put mykey "this is awesome"
OK
> etcdctl get mykey
mykey
this is awesome
#etcd Cluster 상태 확인
etcdctl --endpoints=127.0.0.1:2379,127.0.0.1:2479,127.0.0.1:2579 endpoint status --write-out=table
#etcdctl 확인
etcdctl --endpoints=127.0.0.1:2379,127.0.0.1:2479,127.0.0.1:2579 endpoint health
127.0.0.1:2479 is healthy: successfully committed proposal: took = 5.062031ms
127.0.0.1:2379 is healthy: successfully committed proposal: took = 4.988364ms
127.0.0.1:2579 is healthy: successfully committed proposal: took = 5.038531ms
반드시 screen 으로 하는 것으로 하는 것을 추천 (가급적이면 서비스로 구성하여 로그들 확인)
# primary 로 정상적으로 로그가 발생하면 나머지 2,3 번 replica 들을 실행하는 것을 추천
root@QEMU-Virtual-Machine:/tmp/etcd-download-test# sudo -u postgres patroni /etc/patroni1.yml
root@QEMU-Virtual-Machine:/tmp/etcd-download-test# sudo -u postgres patroni /etc/patroni2.yml
root@QEMU-Virtual-Machine:/tmp/etcd-download-test# sudo -u postgres patroni /etc/patroni3.yml
#정상적으로 올라왔는지 확인하는 명령어
root@QEMU-Virtual-Machine:/data# patronictl -c /etc/patroni1.yml list
+ Cluster: pg-cluster (7527206046275954701) ----+----+-----------+
| Member | Host | Role | State | TL | Lag in MB |
+--------+----------------+---------+-----------+----+-----------+
| node1 | 127.0.0.1:5432 | Leader | running | 1 | |
| node2 | 127.0.0.1:5433 | Replica | streaming | 1 | 0 |
| node3 | 127.0.0.1:5434 | Replica | streaming | 1 | 0 |
+--------+----------------+---------+-----------+----+-----------+
정상적으로 실행된 로그들
root@QEMU-Virtual-Machine:/etc/systemd/system# sudo -u postgres patroni /etc/patroni1.yml
2025-07-15 15:34:06,108 INFO: Selected new etcd server http://127.0.0.1:2579
2025-07-15 15:34:06,152 INFO: No PostgreSQL configuration items changed, nothing to reload.
2025-07-15 15:34:06,195 INFO: Lock owner: None; I am node1
2025-07-15 15:34:06,281 INFO: trying to bootstrap a new cluster
The files belonging to this database system will be owned by user "postgres".
This user must also own the server process.
The database cluster will be initialized with locale "en_US.UTF-8".
The default text search configuration will be set to "english".
Data page checksums are enabled.
creating directory /data/pg1 ... ok
creating subdirectories ... ok
selecting dynamic shared memory implementation ... posix
selecting default "max_connections" ... 100
selecting default "shared_buffers" ... 128MB
selecting default time zone ... Asia/Seoul
creating configuration files ... ok
running bootstrap script ... ok
performing post-bootstrap initialization ... ok
syncing data to disk ... ok
initdb: warning: enabling "trust" authentication for local connections
initdb: hint: You can change this by editing pg_hba.conf or using the option -A, or --auth-local and --auth-host, the next time you run initdb.
Success. You can now start the database server using:
/usr/lib/postgresql/17/bin/pg_ctl -D /data/pg1 -l logfile start
2025-07-15 15:34:06.872 KST [36610] LOG: starting PostgreSQL 17.5 (Ubuntu 17.5-0ubuntu0.25.04.1) on aarch64-unknown-linux-gnu, compiled by gcc (Ubuntu 14.2.0-19ubuntu2) 14.2.0, 64-bit
2025-07-15 15:34:06.872 KST [36610] LOG: listening on IPv4 address "127.0.0.1", port 5433
2025-07-15 15:34:06.873 KST [36610] LOG: listening on Unix socket "/var/run/postgresql/.s.PGSQL.5433"
2025-07-15 15:34:06.876 KST [36613] LOG: database system was shut down at 2025-07-15 15:34:06 KST
2025-07-15 15:34:06,880 INFO: postmaster pid=36610
2025-07-15 15:34:06.880 KST [36610] LOG: database system is ready to accept connections
localhost:5433 - accepting connections
localhost:5433 - accepting connections
2025-07-15 15:34:06,895 INFO: establishing a new patroni heartbeat connection to postgres
2025-07-15 15:34:06,942 INFO: running post_bootstrap
2025-07-15 15:34:06,950 WARNING: Could not activate Linux watchdog device: Can't open watchdog device: [Errno 2] No such file or directory: '/dev/watchdog'
2025-07-15 15:34:07.096 KST [36611] LOG: checkpoint starting: force wait
2025-07-15 15:34:07,125 INFO: initialized a new cluster
2025-07-15 15:34:07.541 KST [36611] LOG: checkpoint complete: wrote 7 buffers (0.0%); 0 WAL file(s) added, 0 removed, 0 recycled; write=0.408 s, sync=0.008 s, total=0.445 s; sync files=6, longest=0.005 s, average=0.002 s; distance=8984 kB, estimate=8984 kB; lsn=0/2000080, redo lsn=0/2000028
2025-07-15 15:34:07.541 KST [36611] LOG: checkpoint starting: force wait
2025-07-15 15:34:07.545 KST [36611] LOG: checkpoint complete: wrote 0 buffers (0.0%); 0 WAL file(s) added, 0 removed, 0 recycled; write=0.001 s, sync=0.001 s, total=0.005 s; sync files=0, longest=0.000 s, average=0.000 s; distance=0 kB, estimate=8085 kB; lsn=0/2000150, redo lsn=0/20000F8
#Replica node log들
root@QEMU-Virtual-Machine:/tmp/etcd-download-test# sudo -u postgres patroni /etc/patroni3.yml
2025-07-15 16:53:53,208 INFO: Selected new etcd server http://127.0.0.1:2379
2025-07-15 16:53:53,253 INFO: No PostgreSQL configuration items changed, nothing to reload.
2025-07-15 16:53:53,296 INFO: Lock owner: node1; I am node3
2025-07-15 16:53:53,339 INFO: trying to bootstrap from leader 'node1'
2025-07-15 16:53:53,548 INFO: replica has been created using basebackup
2025-07-15 16:53:53,549 INFO: bootstrapped from leader 'node1'
2025-07-15 16:53:53,741 INFO: postmaster pid=39826
localhost:5434 - no response
2025-07-15 16:53:53.772 KST [39826] LOG: starting PostgreSQL 17.5 (Ubuntu 17.5-0ubuntu0.25.04.1) on aarch64-unknown-linux-gnu, compiled by gcc (Ubuntu 14.2.0-19ubuntu2) 14.2.0, 64-bit
2025-07-15 16:53:53.772 KST [39826] LOG: listening on IPv4 address "127.0.0.1", port 5434
2025-07-15 16:53:53.773 KST [39826] LOG: listening on Unix socket "/tmp/.s.PGSQL.5434"
2025-07-15 16:53:53.775 KST [39830] LOG: database system was interrupted; last known up at 2025-07-15 16:53:53 KST
2025-07-15 16:53:53.857 KST [39830] LOG: starting backup recovery with redo LSN 0/8000028, checkpoint LSN 0/8000080, on timeline ID 1
2025-07-15 16:53:53.858 KST [39830] LOG: entering standby mode
2025-07-15 16:53:53.860 KST [39830] LOG: redo starts at 0/8000028
2025-07-15 16:53:53.861 KST [39830] LOG: completed backup recovery with redo LSN 0/8000028 and end LSN 0/8000120
2025-07-15 16:53:53.861 KST [39830] LOG: consistent recovery state reached at 0/8000120
2025-07-15 16:53:53.861 KST [39826] LOG: database system is ready to accept read-only connections
2025-07-15 16:53:53.867 KST [39831] LOG: started streaming WAL from primary at 0/9000000 on timeline 1
localhost:5434 - accepting connections
localhost:5434 - accepting connections
2025-07-15 16:53:54,794 INFO: Lock owner: node1; I am node3
2025-07-15 16:53:54,794 INFO: establishing a new patroni heartbeat connection to postgres
2025-07-15 16:53:54,867 INFO: no action. I am (node3), a secondary, and following a leader (node1)
2025-07-15 16:53:59,529 INFO: no action. I am (node3), a secondary, and following a leader (node1)
2025-07-15 16:54:10,074 INFO: no action. I am (node3), a secondary, and following a leader (node1)
2025-07-15 16:54:20,030 INFO: no action. I am (node3), a secondary, and following a leader (node1)
2025-07-15 16:54:30,074 INFO: no action. I am (node3), a secondary, and following a leader (node1)
Patroni Trouble shooting
Patroni 구성하면서 발생한 문제들에 대해 정리
자료가 많지 않아, 구성 중에 설정값 누락도 많이 있었으며, 권한에 대한 이슈도 존재한 것을 작성
Case 1.
설정 중, etcd 설정 정보를 제대로 읽지 못하고, "v2" 에러가 발생 시, 설정값을 변경이 필요.
root@QEMU-Virtual-Machine:/etc/systemd/system# patroni /etc/patroni1.yml
2025-07-15 15:32:49,636 ERROR: Failed to get list of machines from http://127.0.0.1:2479/v2: EtcdException('Bad response : 404 page not found\n')
2025-07-15 15:32:49,637 ERROR: Failed to get list of machines from http://127.0.0.1:2379/v2: EtcdException('Bad response : 404 page not found\n')
2025-07-15 15:32:49,638 ERROR: Failed to get list of machines from http://127.0.0.1:2579/v2: EtcdException('Bad response : 404 page not found\n')
2025-07-15 15:32:49,638 INFO: waiting on etcd
2025-07-15 15:32:54,641 ERROR: Failed to get list of machines from http://127.0.0.1:2479/v2: EtcdException('Bad response : 404 page not found\n')
2025-07-15 15:32:54,645 ERROR: Failed to get list of machines from http://127.0.0.1:2379/v2: EtcdException('Bad response : 404 page not found\n')
2025-07-15 15:32:54,649 ERROR: Failed to get list of machines from http://127.0.0.1:2579/v2: EtcdException('Bad response : 404 page not found\n')
기존 가이드들 보면, 다음과 같이 `etcd` 라고 명칭하지만 이것을 `etcd3` 로 변경하면 해결
root@QEMU-Virtual-Machine:/data# cat /etc/patroni1.yml
scope: pg-cluster
name: node1
restapi:
listen: 0.0.0.0:8008
connect_address: 127.0.0.1:8008
etcd3: #<----- 일반 문서에는 etcd: 로 되어 있음
hosts: 127.0.0.1:2379,127.0.0.1:2479,127.0.0.1:2579
Case 2.
root 에서 patroni 실행 시 정상 실행이 안되는 경우
postgres 계정으로 전환하여 진행
실행 명령어 및 로그 내용
root@QEMU-Virtual-Machine:/tmp/etcd-download-test# patroni /etc/patroni3.yml
2025-07-15 01:57:32,711 INFO: Lock owner: None; I am node3
--> 계속 이러한 로그만 나오고 정상적으로 실행되는 어떠한 내용도 확인이 되지 않음
# 아래 처럼 postgres 계정으로 서비스 시작 진행
root@QEMU-Virtual-Machine:/tmp/etcd-download-test# sudo -u postgres patroni /etc/patroni3.yml
Case 3.
Patroni node 3번이 실행 도중 다음과 같은 에러가 발생하며 문제를 발생
2025-07-15 16:31:47,698 INFO: doing crash recovery in a single user mode
2025-07-15 16:31:47,713 ERROR: Error when reading postmaster.opts
Traceback (most recent call last):
File "/usr/lib/python3/dist-packages/patroni/postgresql/rewind.py", line 545, in read_postmaster_opts
with open(os.path.join(self._postgresql.data_dir, 'postmaster.opts')) as f:
~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: '/data/pg3/postmaster.opts'
2025-07-15 16:31:47,719 ERROR: Crash recovery finished with code=1
2025-07-15 16:31:47,719 INFO: stdout=
2025-07-15 16:31:47,719 INFO: stderr=2025-07-15 16:31:47.718 KST [39181] FATAL: data directory "/data/pg3" has invalid permissions
2025-07-15 16:31:47.718 KST [39181] DETAIL: Permissions should be u=rwx (0700) or u=rwx,g=rx (0750).
log 상에서 다음과 같은 에러가 보인다면, 해당 secondary node 를 재 구축 진행
운영에서는 최신 백업으로 복구 후에 진행하는 것이 시간 단축에 도움
초기 과정에서는 해당 노드를 삭제하고 다시 구성하는 것이 빠르고, 깔끔한 방법
## Error log (replica node)
2025-07-15 16:50:13.401 KST [39717] FATAL: could not receive data from WAL stream: ERROR: requested starting point 0/6000000 is ahead of the WAL flush position of this server 0/5050660
## 이 오류 메시지는 PostgreSQL 스트리밍 복제가 시작될 때 레플리카 노드가 요청한 WAL 시점이 프라이머리 노드가 아직 생성하지 않은 LSN(Log Sequence Number)에 있다는 것을 의미(제대로 복제 데이터를 가져오지 못한 현상)
################################################################################
## 삭제 후 재구축
# 레플리카 노드에서 실행 (중요: primary가 정상 상태여야 함)
# patroni 를 강제 중지 또는
sudo systemctl stop patroni3 # 프로세스 정지
# 데이터 디렉토리 정리 (중요: 실수로 primary에서 하지 않도록 주의)
rm -rf /data/pg3/*
# 또는 수동으로 초기화된 basebackup
sudo -u postgres pg_basebackup -h <primary_ip> -D /data/pg3 -U replicator -P -R
# 퍼미션 재확인
chown -R postgres:postgres /data/pg3
chmod 700 /data/pg3
# Patroni 재시작
sudo systemctl start patroni 또는
root@QEMU-Virtual-Machine:/tmp/etcd-download-test# sudo -u postgres patroni /etc/patroni3.yml
vi /data/pg1/postgresql.conf
# config 파일 위치
data_directory = '/data/pg1/data'
hba_file = '/data/pg1/pg_hba.conf'
ident_file = '/data/pg1/pg_ident.conf'
#logging 및 기본 설정 정보 수정
logging_collector = on
log_directory = '/data/pg1/log'
log_filename = 'postgresql-%Y-%m-%d.log'
log_rotation_age = 1d
log_rotation_size = 0
