PostgreSQL मूल उच्च उपलब्धता: पेट्रोनी, स्ट्रीमिंग प्रतिकृति, और उत्पादन विफलता रणनीतियाँ
पेट्रोनी, स्ट्रीमिंग प्रतिकृति और HAProxy के साथ PostgreSQL नेटिव HA
एकल PostgreSQL इंस्टेंस को चलाना तब तक सरल है जब तक कि पहला अनियोजित आउटेज आपको याद न दिला दे कि एक डेटाबेस केवल उसकी उपलब्धता जितना ही मूल्यवान है। डिस्क विफलता, कर्नेल पैनिक, नेटवर्क विभाजन, और असफल अपग्रेड सैद्धांतिक जोखिम नहीं हैं - वे काफी लंबी समयरेखा पर परिचालन निश्चितताएं हैं। PostgreSQL बिल्ट-इन स्वचालित फ़ेलओवर के साथ शिप नहीं होता है, लेकिन यह अत्यधिक उपलब्ध क्लस्टर बनाने के लिए आवश्यक सभी प्रतिकृति प्राइमेटिव प्रदान करता है। पैट्रोनी, ज़ालैंडो द्वारा अनुरक्षित एक ओपन-सोर्स HA फ्रेमवर्क है, जो उन प्राइमेटिव्स को एक प्रोडक्शन-ग्रेड फेलओवर सिस्टम में व्यवस्थित करता है, जिसका दुनिया भर में हजारों PostgreSQL क्लस्टरों में बड़े पैमाने पर युद्ध-परीक्षण किया गया है।
यह आलेख एक गहन इंजीनियरिंग मार्गदर्शिका है। हम PostgreSQL स्ट्रीमिंग प्रतिकृति (सिंक्रोनस और एसिंक्रोनस), पेट्रोनी आर्किटेक्चर और कॉन्फ़िगरेशन आदि को एक वितरित कॉन्फ़िगरेशन स्टोर के रूप में कवर करेंगे, रीड-राइट स्प्लिटिंग के साथ कनेक्शन रूटिंग के लिए HAProxy, कनेक्शन पूलिंग के लिए PgBouncer, WAL संग्रह और पॉइंट-इन-टाइम रिकवरी, चयनात्मक डेटा सिंक्रनाइज़ेशन के लिए तार्किक प्रतिकृति, प्रारंभिक स्टैंडबाय प्रोविजनिंग के लिए pg_basebackup, पेट्रोनी के विकल्प के रूप में रिपएमजीआर, क्लाउड-विशिष्ट परिनियोजन पैटर्न AWS, Azure और GCP के लिए, Rancher और Longhorn के साथ बेयर मेटल k3s परिनियोजन, pg_stat_replication और Prometheus/Grafana के साथ निगरानी, स्विचओवर बनाम फेलओवर प्रक्रियाएं, स्प्लिट-ब्रेन रोकथाम, उत्पादन ट्यूनिंग, और फेलओवर सत्यापन के लिए कैओस इंजीनियरिंग।
PostgreSQL स्ट्रीमिंग प्रतिकृति बुनियादी बातें
स्ट्रीमिंग प्रतिकृति PostgreSQL की उच्च उपलब्धता की रीढ़ है। यह प्राथमिक सर्वर से राइट-अहेड लॉग (वाल) रिकॉर्ड को एक या अधिक स्टैंडबाय सर्वर पर लगातार शिपिंग करके काम करता है। स्टैंडबाय उन वाल रिकॉर्ड्स को वास्तविक समय में लागू करता है, प्राथमिक डेटा की लगभग समान प्रतिलिपि बनाए रखता है। यह तंत्र PostgreSQL 9.0 में पेश किया गया था और प्रत्येक आगामी रिलीज़ में इसे परिष्कृत किया गया है।
स्ट्रीमिंग प्रतिकृति के दो तरीके हैं:एसिंक्रोनसऔरसिंक्रोनस। एसिंक्रोनस मोड में, प्राथमिक लेनदेन करने से पहले वाल रिकॉर्ड की प्राप्ति की पुष्टि करने के लिए स्टैंडबाय की प्रतीक्षा नहीं करता है। यह अधिकतम लेखन प्रदर्शन देता है लेकिन संभावित डेटा हानि की एक विंडो पेश करता है - यदि स्टैंडबाय को सबसे हालिया वाल प्राप्त होने से पहले प्राथमिक विफल हो जाता है, तो वे लेनदेन खो जाते हैं। सिंक्रोनस मोड में, प्राथमिक यह पुष्टि करने के लिए कम से कम एक स्टैंडबाय की प्रतीक्षा करता है कि लेनदेन को प्रतिबद्ध के रूप में रिपोर्ट करने से पहले वाल रिकॉर्ड को टिकाऊ भंडारण में लिखा गया है। यह बढ़ी हुई प्रतिबद्धता विलंबता की कीमत पर डेटा हानि को समाप्त करता है, क्योंकि प्रत्येक लेखन को स्टैंडबाय पर राउंड-ट्रिप करना होगा।
सिंक्रोनस और एसिंक्रोनस प्रतिकृति के बीच चयन बाइनरी नहीं है। PostgreSQL सत्र स्तर परsynchronous_commitका समर्थन करता है, इसलिए विलंबता-संवेदनशील वर्कलोड एसिंक्रोनस कमिट में विकल्प चुन सकते हैं जबकि महत्वपूर्ण वित्तीय लेनदेन एक ही क्लस्टर के भीतर सिंक्रोनस कमिट का उपयोग करते हैं।
प्रतिकृति
के लिए प्राथमिक को कॉन्फ़िगर करनाप्राथमिक सर्वर को प्रतिकृति के लिए पर्याप्त स्तर पर वाल रिकॉर्ड उत्पन्न करने और स्टैंडबाय कनेक्शन की अनुमति देने के लिए कॉन्फ़िगर किया जाना चाहिए। निम्नलिखितpostgresql.confसेटिंग्स आवश्यक हैं।
# postgresql.conf on the primary
wal_level = replica # minimum for streaming replication
max_wal_senders = 10 # max concurrent replication connections
max_replication_slots = 10 # prevent WAL removal before standby consumption
wal_keep_size = 2GB # retain WAL as fallback if slots are unused
hot_standby = on # allow read queries on standbys
synchronous_commit = on # 'on' for sync, 'off' for pure async
synchronous_standby_names = 'ANY 1 (standby1, standby2)' # sync replication targets
archive_mode = on # enable WAL archiving for PITR
archive_command = 'test ! -f /archive/%f && cp %p /archive/%f'
listening_addresses = '*'
port = 5432प्रतिकृति कनेक्शन के लिएप्रमाणीकरणpg_hba.confमें नियंत्रित किया जाता है। प्रतिकृति कनेक्शन एक समर्पित कनेक्शन प्रकार का उपयोग करते हैं।
# pg_hba.conf — replication entries
# TYPE DATABASE USER ADDRESS METHOD
host replication replicator 10.0.1.0/24 scram-sha-256
host replication replicator 10.0.2.0/24 scram-sha-256
host all all 10.0.0.0/16 scram-sha-256प्राथमिक पर प्रतिकृति उपयोगकर्ता बनाएं।
CREATE ROLE replicator WITH REPLICATION LOGIN PASSWORD 'strong_replication_password';pg_basebackup
के साथ एक स्टैंडबाय का प्रावधानpg_basebackupउपयोगिता प्राथमिक डेटा निर्देशिका की एक भौतिक प्रतिलिपि बनाती है, जो एक नए स्टैंडबाय के लिए शुरुआती बिंदु बन जाती है। यह बेस बैकअप और वाल स्ट्रीमिंग को परमाणु रूप से संभालता है, इसलिए परिणामी प्रतिलिपि सुसंगत है।
# On the standby server
pg_basebackup -h primary-host -U replicator -D /var/lib/postgresql/16/main \
-Fp -Xs -P -R
# -Fp: plain format
# -Xs: stream WAL during backup
# -P: show progress
# -R: create standby.signal and configure primary_conninfo in postgresql.auto.conf-Rध्वज महत्वपूर्ण है - यहprimary_conninfoकोpostgresql.auto.confमें लिखता है औरstandby.signalबनाता है, जो PostgreSQL को स्टैंडबाय मोड में शुरू करने के लिए कहता है। PostgreSQL 12 और बाद में,recovery.confको इन दो तंत्रों द्वारा प्रतिस्थापित किया गया है।
# postgresql.auto.conf (generated by pg_basebackup -R)
primary_conninfo = 'host=primary-host port=5432 user=replicator password=strong_replication_password application_name=standby1'
primary_slot_name = 'standby1_slot'स्टैंडबाय शुरू करने से पहले प्राथमिक पर प्रतिकृति स्लॉट बनाएं, ताकि स्टैंडबाय का उपभोग करने से पहले वाल को साफ होने से रोका जा सके।
SELECT pg_create_physical_replication_slot('standby1_slot');
SELECT pg_create_physical_replication_slot('standby2_slot');संरक्षक: स्वचालित HA ऑर्केस्ट्रेशन
स्ट्रीमिंग प्रतिकृति आपको डेटा अतिरेक देती है, लेकिन यह आपको स्वचालित विफलता नहीं देती है। यदि प्राथमिक क्रैश हो जाता है, तो किसी को - एक मानव ऑपरेटर या एक स्वचालन प्रणाली - को प्राथमिक में एक स्टैंडबाय को बढ़ावा देना होगा, नए प्राथमिक का पालन करने के लिए शेष स्टैंडबाय को फिर से कॉन्फ़िगर करना होगा, और कनेक्शन रूटिंग को अपडेट करना होगा। पेट्रोनी यह सब स्वचालित करता है।
पेट्रोनी एक Python डेमॉन है जो प्रत्येक PostgreSQL इंस्टेंस के साथ चलता है। यह नेता चुनाव और क्लस्टर स्थिति के समन्वय के लिए एक वितरित कॉन्फ़िगरेशन स्टोर (डीसीएस) का उपयोग करता है - आमतौर पर आदि, लेकिन ज़ूकीपर या कॉन्सल का भी। प्रत्येक पेट्रोनी नोड लगातार डीसीएस को अपनी स्वास्थ्य स्थिति लिखता है। जब लीडर (प्राथमिक) कॉन्फ़िगर टीटीएल के भीतर अपनी डीसीएस कुंजी को नवीनीकृत करने में विफल रहता है, तो पेट्रोनी स्वस्थ स्टैंडबाय के बीच लीडर चुनाव शुरू करता है। विजेता को प्राथमिक में पदोन्नत किया जाता है, और शेष नोड्स खुद को नए प्राथमिक के स्टैंडबाय के रूप में पुन: कॉन्फ़िगर करते हैं - सभी स्वचालित रूप से, आमतौर पर 10-30 सेकंड के भीतर।
पेट्रोनी YAML कॉन्फ़िगरेशन
पेट्रोनी को YAML फ़ाइल के माध्यम से कॉन्फ़िगर किया गया है जो DCS कनेक्शन, PostgreSQL पैरामीटर, प्रतिकृति व्यवहार और बूटस्ट्रैप सेटिंग्स को परिभाषित करता है। प्राथमिक नोड के लिए उत्पादन-ग्रेड कॉन्फ़िगरेशन निम्नलिखित है।
# /etc/patroni/patroni.yml — Node 1 (Primary)
scope: pg-ha-cluster
namespace: /postgresql-ha/
name: node1
restapi:
listen: 0.0.0.0:8008
connect_address: 10.0.1.10:8008
etcd3:
hosts:
- 10.0.2.10:2379
- 10.0.2.11:2379
- 10.0.2.12:2379
bootstrap:
dcs:
ttl: 30
loop_wait: 10
retry_timeout: 10
maximum_lag_on_failover: 1048576 # 1MB — only promote standbys within this lag
synchronous_mode: true
synchronous_mode_strict: false
postgresql:
use_pg_rewind: true
use_slots: true
parameters:
wal_level: replica
hot_standby: 'on'
max_connections: 200
max_wal_senders: 10
max_replication_slots: 10
wal_keep_size: 2GB
synchronous_commit: 'on'
archive_mode: 'on'
archive_command: 'test ! -f /archive/%f && cp %p /archive/%f'
archive_timeout: 60
wal_log_hints: 'on'
shared_preload_libraries: 'pg_stat_statements'
track_commit_timestamp: 'on'
pg_hba:
- host replication replicator 10.0.0.0/16 scram-sha-256
- host all all 10.0.0.0/16 scram-sha-256
- host all all 0.0.0.0/0 scram-sha-256
initdb:
- encoding: UTF8
- data-checksums
users:
admin:
password: 'admin_secure_password'
options:
- createrole
- createdb
replicator:
password: 'repl_secure_password'
options:
- replication
postgresql:
listen: 0.0.0.0:5432
connect_address: 10.0.1.10:5432
data_dir: /var/lib/postgresql/16/main
bin_dir: /usr/lib/postgresql/16/bin
config_dir: /var/lib/postgresql/16/main
pgpass: /tmp/pgpass0
authentication:
superuser:
username: postgres
password: 'postgres_secure_password'
replication:
username: replicator
password: 'repl_secure_password'
rewind:
username: postgres
password: 'postgres_secure_password'
parameters:
unix_socket_directories: '/var/run/postgresql'
create_replica_methods:
- basebackup
basebackup:
max-rate: 100M
checkpoint: fast
tags:
nofailover: false
noloadbalance: false
clonefrom: false
nosync: falseस्टैंडबाय नोड्स अपने स्वयं केname,connect_addressऔरlistenमानों के साथ एक समान कॉन्फ़िगरेशन का उपयोग करते हैं। पैट्रोनी बाकी काम संभालता है - यह पता लगाता है कि क्या नोड को डीसीएस स्थिति के आधार पर लीडर या प्रतिकृति होना चाहिए और तदनुसार PostgreSQL को कॉन्फ़िगर करता है।
को वितरित कॉन्फ़िगरेशन स्टोर
के रूप में जाना जाता हैआदि पेट्रोनी क्लस्टर का तंत्रिका तंत्र है। यह वर्तमान लीडर पहचान, क्लस्टर टोपोलॉजी, वांछित कॉन्फ़िगरेशन और प्रत्येक नोड की स्वास्थ्य स्थिति को संग्रहीत करता है। तीन-नोड आदि क्लस्टर उत्पादन के लिए न्यूनतम है, जो कोरम बनाए रखते हुए एक नोड विफलता को सहन करता है।
# Install and configure etcd on three dedicated nodes
# /etc/etcd/etcd.conf.yml — Node etcd1 (10.0.2.10)
name: etcd1
data-dir: /var/lib/etcd
listen-client-urls: http://0.0.0.0:2379
listen-peer-urls: http://0.0.0.0:2380
advertise-client-urls: http://10.0.2.10:2379
initial-advertise-peer-urls: http://10.0.2.10:2380
initial-cluster: etcd1=http://10.0.2.10:2380,etcd2=http://10.0.2.11:2380,etcd3=http://10.0.2.12:2380
initial-cluster-state: new
initial-cluster-token: patroni-etcd-cluster
# Start etcd
systemctl enable --now etcd
# Verify cluster health
etcdctl endpoint health --cluster \
--endpoints=http://10.0.2.10:2379,http://10.0.2.11:2379,http://10.0.2.12:2379उत्पादन परिनियोजन के लिए, आदि साथियों के बीच और आदि और पेट्रोनी ग्राहकों के बीच TLS सक्षम करें। अनएन्क्रिप्टेड आदि ट्रैफ़िक नेटवर्क-स्तरीय हमलावरों के लिए क्लस्टर क्रेडेंशियल और कॉन्फ़िगरेशन को उजागर करता है।
कनेक्शन रूटिंगके लिएHAProxy
पेट्रोनी प्रत्येक नोड पर एक REST API प्रदर्शित करता है (डिफ़ॉल्ट रूप से पोर्ट 8008) जो रिपोर्ट करता है कि नोड वर्तमान लीडर है या प्रतिकृति। HAProxy ट्रैफ़िक को रूट करने के लिए इन स्वास्थ्य जांच समापन बिंदुओं का उपयोग करता है: लिखता है लीडर के पास जाता है, पढ़ता है स्वस्थ प्रतिकृतियों पर जाता है। यह आपको बिना किसी एप्लिकेशन-स्तर परिवर्तन के स्वचालित पढ़ने-लिखने का विभाजन देता है।
# /etc/haproxy/haproxy.cfg
global
maxconn 2000
log /dev/log local0
stats socket /var/run/haproxy.sock mode 660 level admin
defaults
mode tcp
log global
retries 3
timeout client 30m
timeout connect 4s
timeout server 30m
timeout check 5s
maxconn 1000
listen pg_write
bind *:5000
option httpchk GET /primary
http-check expect status 200
default-server inter 3s fall 3 rise 2 on-marked-down shutdown-sessions
server node1 10.0.1.10:5432 check port 8008
server node2 10.0.1.11:5432 check port 8008
server node3 10.0.1.12:5432 check port 8008
listen pg_read
bind *:5001
balance roundrobin
option httpchk GET /replica
http-check expect status 200
default-server inter 3s fall 3 rise 2 on-marked-down shutdown-sessions
server node1 10.0.1.10:5432 check port 8008
server node2 10.0.1.11:5432 check port 8008
server node3 10.0.1.12:5432 check port 8008
listen stats
bind *:7000
mode http
stats enable
stats uri /
stats refresh 10s/primaryएंडपॉइंट केवल वर्तमान पेट्रोनी लीडर पर HTTP 200 लौटाता है।/replicaएंडपॉइंट स्वस्थ स्टैंडबाय पर 200 रिटर्न देता है। जब कोई फ़ेलओवर होता है, तो नया प्राइमरी/primaryपर 200 लौटाना शुरू कर देता है, और HAProxy स्वचालित रूप से राइट ट्रैफ़िक को रीडायरेक्ट करता है - आमतौर पर एकल स्वास्थ्य जांच अंतराल (3 सेकंड) के भीतर।on-marked-down shutdown-sessionsनिर्देश विफल प्राइमरी से मौजूदा कनेक्शन को तुरंत समाप्त कर देता है, जिससे ग्राहकों को नए लीडर से फिर से जुड़ने के लिए मजबूर होना पड़ता है।
PgBouncer
PostgreSQL प्रत्येक क्लाइंट कनेक्शन के लिए एक नई बैकएंड प्रक्रिया बनाता है। पैमाने पर - सैकड़ों या हजारों माइक्रोसर्विसेज प्रत्येक कनेक्शन पूल बनाए रखते हैं - प्रक्रिया निर्माण और मेमोरी खपत का ओवरहेड महत्वपूर्ण हो जाता है। PgBouncer एप्लिकेशन और PostgreSQL के बीच बैठता है, सर्वर-साइड कनेक्शन का एक पूल बनाए रखता है और उन पर क्लाइंट कनेक्शन को मल्टीप्लेक्स करता है।
# /etc/pgbouncer/pgbouncer.ini
[databases]
* = host=127.0.0.1 port=5432 dbname=appdb
[pgbouncer]
listen_addr = 0.0.0.0
listen_port = 6432
auth_type = scram-sha-256
auth_file = /etc/pgbouncer/userlist.txt
pool_mode = transaction
max_client_conn = 1000
default_pool_size = 50
min_pool_size = 10
reserve_pool_size = 10
reserve_pool_timeout = 3
server_lifetime = 3600
server_idle_timeout = 600
server_connect_timeout = 5
server_login_retry = 3
log_connections = 1
log_disconnections = 1
stats_period = 60जब पैट्रोनी के साथ प्रयोग किया जाता है, तो PgBouncer आमतौर पर प्रत्येक PostgreSQL नोड या HAProxy नोड्स पर सह-स्थित होता है।transactionपूल मोड अधिकांश कार्यभार के लिए सबसे अच्छा विकल्प है - यह लेनदेन की अवधि के लिए एक सर्वर कनेक्शन प्रदान करता है और लेनदेन के बीच इसे पूल में वापस कर देता है। यहsessionमोड से कहीं अधिक कुशल है, जो पूरे क्लाइंट सत्र के लिए कनेक्शन रखता है।
वाल आर्काइविंग और पॉइंट-इन-टाइम रिकवरी
स्ट्रीमिंग प्रतिकृति सर्वर विफलता से बचाती है, लेकिन यह तार्किक त्रुटियों से रक्षा नहीं करती है - एक आकस्मिकDROP TABLEया खराब एप्लिकेशन माइग्रेशन तुरंत सभी स्टैंडबाय पर दोहराया जाता है। पॉइंट-इन-टाइम रिकवरी (पीआईटीआर) के साथ संयुक्त वाल संग्रह आपको त्रुटि होने से पहले किसी भी क्षण को पुनर्स्थापित करने की सुविधा देता है।
वाल संग्रह प्रतियों ने वाल खंडों को एक टिकाऊ संग्रह में पूरा किया - आमतौर पर एक एस 3 बाल्टी, एक एनएफएस माउंट, या एक समर्पित बैकअप सर्वर।pgBackRestऔरWAL-Gजैसे उपकरण संपीड़न, एन्क्रिप्शन और समानांतर स्थानांतरण के साथ कुशलतापूर्वक संग्रह को संभालते हैं।
# pgBackRest configuration — /etc/pgbackrest/pgbackrest.conf
[global]
repo1-type=s3
repo1-s3-bucket=pg-wal-archive
repo1-s3-endpoint=s3.eu-west-1.amazonaws.com
repo1-s3-region=eu-west-1
repo1-s3-key=AKIAIOSFODNN7EXAMPLE
repo1-s3-key-secret=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
repo1-path=/pgbackrest
repo1-retention-full=4
repo1-retention-diff=7
repo1-cipher-type=aes-256-cbc
repo1-cipher-pass=strong_encryption_passphrase
compress-type=zst
compress-level=3
process-max=4
[pg-ha-cluster]
pg1-path=/var/lib/postgresql/16/main
pg1-port=5432
# In postgresql.conf
archive_command = 'pgbackrest --stanza=pg-ha-cluster archive-push %p'
restore_command = 'pgbackrest --stanza=pg-ha-cluster archive-get %f "%p"'पॉइंट-इन-टाइम पुनर्प्राप्ति करने के लिए, एक लक्ष्य टाइमस्टैम्प निर्दिष्ट करें।
# Restore to a specific point in time
pgbackrest --stanza=pg-ha-cluster --type=time \
--target="2026-04-12 11:25:00" \
--target-action=promote \
restoreचयनात्मक डेटा सिंकके लिएतार्किक प्रतिकृति
जबकि स्ट्रीमिंग प्रतिकृति संपूर्ण डेटाबेस क्लस्टर की एक सटीक भौतिक प्रतिलिपि बनाती है, तार्किक प्रतिकृति तालिका स्तर पर संचालित होती है, स्वतंत्र PostgreSQL उदाहरणों के बीच व्यक्तिगत तालिकाओं या डेटा के सबसेट की प्रतिकृति बनाती है। यह शून्य-डाउनटाइम प्रमुख संस्करण अपग्रेड, क्रॉस-रीजन रीड प्रतिकृतियों के लिए उपयोगी है जिन्हें केवल विशिष्ट तालिकाओं, डेटा वेयरहाउस फीडिंग और मल्टी-टेनेंट डेटा वितरण की आवश्यकता होती है।
# On the publisher (source database)
wal_level = logical # must be 'logical' — higher than 'replica'
CREATE PUBLICATION app_pub FOR TABLE orders, customers, products;
# On the subscriber (target database)
CREATE SUBSCRIPTION app_sub
CONNECTION 'host=publisher-host port=5432 dbname=appdb user=replicator password=pass'
PUBLICATION app_pub;तार्किक प्रतिकृति स्ट्रीमिंग प्रतिकृति के साथ चल सकती है। एक सामान्य पैटर्न एचए (फास्ट फिजिकल फेलओवर) के लिए स्ट्रीमिंग प्रतिकृति और क्रॉस-रीजन एनालिटिक्स प्रतिकृतियों के लिए तार्किक प्रतिकृति का उपयोग करना है, जिन्हें केवल तालिकाओं के सबसेट की आवश्यकता होती है।
बहु-क्षेत्र स्ट्रीमिंग प्रतिकृति
आपदा पुनर्प्राप्ति और वैश्विक पठन प्रदर्शन के लिए, PostgreSQL क्लस्टर कई क्षेत्रों तक फैल सकते हैं। मानक पैटर्न एक क्षेत्र के भीतर समकालिक प्रतिकृति (स्थानीय विफलता पर शून्य डेटा हानि के लिए) और क्षेत्रों में अतुल्यकालिक प्रतिकृति (प्रत्येक लेखन पर क्रॉस-क्षेत्र विलंबता दंड से बचने के लिए) है। स्थानीय रीड रूटिंग के लिए प्रत्येक क्षेत्र की अपनी HAProxy होती है।
फ़ेलओवर और स्विचओवर प्रक्रियाएँ
फेलओवर और स्विचओवर के बीच अंतर को समझना महत्वपूर्ण है।फेलओवरएक अनियोजित प्रमोशन है जो वर्तमान प्राइमरी की विफलता के कारण शुरू हुआ है।स्विचओवरएक योजनाबद्ध, सुंदर भूमिका परिवर्तन है - आमतौर पर रखरखाव से पहले किया जाता है। पेट्रोनी दोनों का समर्थन करते हैं।
नियोजित स्विचओवर
# List cluster members
patronictlctl -c /etc/patroni/patroni.yml list
# Perform switchover to a specific node
patronictlctl -c /etc/patroni/patroni.yml switchover \
--master node1 --candidate node2 --force
# Or use the Patroni REST API
curl -s http://10.0.1.10:8008/switchover -XPOST \
-d '{"leader": "node1", "candidate": "node2"}'एक स्विचओवर के दौरान, पेट्रोनी वर्तमान प्राथमिक को स्टैंडबाय में पदावनत करता है, लक्ष्य उम्मीदवार को बढ़ावा देता है, और नए प्राथमिक का पालन करने के लिए अन्य सभी स्टैंडबाय को पुन: कॉन्फ़िगर करता है। इस प्रक्रिया में 5-15 सेकंड का समय लगता है। HAProxy स्वास्थ्य जांच के माध्यम से परिवर्तन का पता लगाता है और ट्रैफ़िक को स्वचालित रूप से पुनर्निर्देशित करता है।
स्वचालित विफलता अनुक्रम
जब प्राथमिक अप्रत्याशित रूप से विफल हो जाता है, तो पेट्रोनी सेवा को बहाल करने के लिए एक सटीक अनुक्रम का पालन करता है। निम्नलिखित चित्र चरणों को दर्शाता है।
स्प्लिट-ब्रेन प्रिवेंशन
स्प्लिट-ब्रेन - जहां दो नोड्स एक साथ मानते हैं कि वे प्राथमिक हैं - किसी भी HA सिस्टम में सबसे खतरनाक विफलता मोड है। पेट्रोनी कई तंत्रों के माध्यम से मस्तिष्क के विभाजन को रोकता है:
- DCS-आधारित लीडर लॉक:केवल एक नोड किसी भी समय आदि में लीडर कुंजी रख सकता है। कुंजी में एक टीटीएल है, और नेता को इसे लगातार नवीनीकृत करना होगा। यदि कोई नेटवर्क विभाजन लीडर को आदि से अलग कर देता है, तो कुंजी समाप्त हो जाती है, और लीडर स्वयं को पदावनत कर देता है।
- वॉचडॉग:पेट्रोनी एक लिनक्स वॉचडॉग डिवाइस (
/dev/watchdog) को कॉन्फ़िगर कर सकता है। यदि पैट्रोनी डीसीएस तक पहुंच खो देता है और पुष्टि नहीं कर पाता है कि उसे लीडर बने रहना चाहिए, तो वॉचडॉग नोड को रीबूट या पावर-ऑफ कर देगा - एक हार्ड फेंसिंग तंत्र जो गारंटी देता है कि पुराना प्राथमिक लेखन स्वीकार करना जारी नहीं रखता है। - pg_rewind:जब कोई पूर्व प्राथमिक ऑनलाइन वापस आता है, तो इसमें वाल रिकॉर्ड हो सकते हैं जिन्हें कभी दोहराया नहीं गया था।
pg_rewindसमयरेखा को विचलन के बिंदु पर रिवाइंड करता है, जिससे नोड को पूर्ण बेस बैकअप के बिना स्टैंडबाय के रूप में फिर से जुड़ने की अनुमति मिलती है। पेट्रोनी कीuse_pg_rewind: trueसेटिंग इसे स्वचालित करती है।
# Enable watchdog in Patroni config
bootstrap:
dcs:
postgresql:
use_pg_rewind: true
parameters:
wal_log_hints: 'on' # required for pg_rewind
# Watchdog configuration
watchdog:
mode: required # 'off', 'automatic', or 'required'
device: /dev/watchdog
safety_margin: 5 # seconds before TTL expiry to trigger watchdogपेट्रोनीके विकल्प के रूप मेंरिपीटग्राम
repmgrPostgreSQL के लिए एक और लोकप्रिय HA टूल है। यह स्टैंडबाय प्रबंधन, स्वचालित फेलओवर और स्विचओवर क्षमताएं प्रदान करता है। हालाँकि, यह पेट्रोनी से मौलिक रूप से भिन्न दृष्टिकोण अपनाता है। रिपएमजीआर एक वितरित सर्वसम्मति स्टोर के बजाय विफलता का पता लगाने के लिए एक गवाह नोड और एक डेमॉन (repmgrd) का उपयोग करता है। इससे इसे तैनात करना आसान हो जाता है लेकिन जटिल नेटवर्क विभाजन परिदृश्यों में स्प्लिट-ब्रेन के प्रति अधिक संवेदनशील हो जाता है।
# repmgr.conf on the primary
node_id=1
node_name='node1'
conninfo='host=10.0.1.10 user=repmgr dbname=repmgr connect_timeout=2'
data_directory='/var/lib/postgresql/16/main'
failover=automatic
promote_command='repmgr standby promote -f /etc/repmgr.conf --log-to-file'
follow_command='repmgr standby follow -f /etc/repmgr.conf --log-to-file --upstream-node-id=%n'
monitoring_history=yes
monitor_interval_secs=5
reconnect_attempts=6
reconnect_interval=10नई तैनाती के लिए, इसकी मजबूत विभाजन-मस्तिष्क रोकथाम गारंटी और अधिक सक्रिय विकास समुदाय के कारण पेट्रोनी अनुशंसित विकल्प है। सरल सेटअपों या टूल में पहले से ही निवेशित संगठनों के लिए रिपएमजीआर एक उचित विकल्प बना हुआ है।
क्लाउड परिनियोजन पैटर्न
AWS परिनियोजन: EC2, EBS, और Route53
AWS पर, प्रत्येक PostgreSQL + पेट्रोनी नोड को EBS gp3 या io2 वॉल्यूम के साथ EC2 इंस्टेंस पर तैनात करें। HA के लिए एकाधिक उपलब्धता क्षेत्रों में अलग-अलग उदाहरणों का उपयोग करें। आदि नोड्स को भी AZs तक फैलाना चाहिए।
# Terraform sketch for PostgreSQL HA on AWS
resource "aws_instance" "pg_node" {
count = 3
ami = "ami-0abcdef1234567890" # Ubuntu 22.04
instance_type = "r6g.2xlarge" # 8 vCPU, 64GB RAM
subnet_id = aws_subnet.private[count.index].id
vpc_security_group_ids = [aws_security_group.pg_sg.id]
availability_zone = element(["eu-west-1a", "eu-west-1b", "eu-west-1c"], count.index)
root_block_device {
volume_size = 50
volume_type = "gp3"
}
tags = {
Name = "pg-node-${count.index + 1}"
Role = "patroni"
}
}
resource "aws_ebs_volume" "pg_data" {
count = 3
availability_zone = element(["eu-west-1a", "eu-west-1b", "eu-west-1c"], count.index)
size = 500
type = "gp3"
iops = 6000
throughput = 250
encrypted = true
tags = {
Name = "pg-data-${count.index + 1}"
}
}
resource "aws_route53_health_check" "pg_primary" {
count = 3
ip_address = aws_instance.pg_node[count.index].private_ip
port = 8008
type = "HTTP"
resource_path = "/primary"
failure_threshold = 3
request_interval = 10
}यदि आप AWS-प्रबंधित समाधान पसंद करते हैं तोHAProxy के बजाय नेटवर्क लोड बैलेंसर (NLB) का उपयोग करें। एनएलबी ट्रैफ़िक को वर्तमान प्राथमिक तक रूट करने के लिए पेट्रोनी REST API के विरुद्ध लक्ष्य समूह स्वास्थ्य जांच का उपयोग कर सकता है।
Azure परिनियोजन: VMs, प्रबंधित डिस्क, और Azure LB
Azure पर, डेटा वॉल्यूम के लिए प्रीमियम SSD प्रबंधित डिस्क के साथ मानक_E8s_v5 VM (मेमोरी-अनुकूलित) का उपयोग करें। उपलब्धता क्षेत्रों में तैनात करें। Azure लोड बैलेंसर पेट्रोनी REST API के विरुद्ध स्वास्थ्य जांच के साथ HAProxy के समतुल्य प्रदान करता है।
# Azure CLI — create PostgreSQL VM with Managed Disk
az vm create \
--resource-group pg-ha-rg \
--name pg-node-1 \
--image Canonical:0001-com-ubuntu-server-jammy:22_04-lts:latest \
--size Standard_E8s_v5 \
--zone 1 \
--vnet-name pg-vnet \
--subnet pg-subnet \
--nsg pg-nsg \
--admin-username pgadmin \
--ssh-key-value ~/.ssh/id_rsa.pub
az disk create \
--resource-group pg-ha-rg \
--name pg-data-1 \
--size-gb 512 \
--sku Premium_LRS \
--zone 1
az vm disk attach \
--resource-group pg-ha-rg \
--vm-name pg-node-1 \
--name pg-data-1
# Azure Load Balancer health probe for Patroni
az network lb probe create \
--resource-group pg-ha-rg \
--lb-name pg-lb \
--name patroni-primary-probe \
--protocol Http \
--port 8008 \
--path /primary \
--interval 5 \
--threshold 3GCP परिनियोजन: कंप्यूट इंजन और क्लाउड लोड संतुलन
GCP पर, SSD पर्सिस्टेंट डिस्क के साथ n2-highmem-8 इंस्टेंसेस (8 vCPU, 64GB RAM) का उपयोग करें। एक क्षेत्र के भीतर जोनों में वितरित करें। पैट्रोनी स्वास्थ्य जांच के साथ एक आंतरिक टीसीपी/यूडीपी लोड बैलेंसर का उपयोग करें।
# GCP — create instance and persistent disk
gcloud compute instances create pg-node-1 \
--zone=europe-west1-b \
--machine-type=n2-highmem-8 \
--image-family=ubuntu-2204-lts \
--image-project=ubuntu-os-cloud \
--boot-disk-size=50GB \
--network=pg-network \
--subnet=pg-subnet
gcloud compute disks create pg-data-1 \
--zone=europe-west1-b \
--size=500GB \
--type=pd-ssd
gcloud compute instances attach-disk pg-node-1 \
--disk=pg-data-1 \
--zone=europe-west1-b
# Health check for Patroni primary endpoint
gcloud compute health-checks create http patroni-primary-check \
--port=8008 \
--request-path=/primary \
--check-interval=5s \
--timeout=5s \
--unhealthy-threshold=3 \
--healthy-threshold=2रैंचर और लॉन्गहॉर्नके साथबेयर मेटल k3s परिनियोजन
उन संगठनों के लिए जो अपने स्वयं के हार्डवेयर का संचालन करते हैं, k3s, Rancher और Longhorn के साथ नंगे धातु पर PostgreSQL HA को तैनात करना पूरी तरह से ओपन-सोर्स, क्लाउड-स्वतंत्र बुनियादी ढांचा प्रदान करता है। k3s एक हल्का Kubernetes वितरण है जो पूर्ण Kubernetes वितरण के ओवरहेड के बिना नंगे धातु सर्वर पर कुशलतापूर्वक चलता है।
k3s और लॉन्गहॉर्न सेटअप
# Install k3s on the first server node
curl -sfL https://get.k3s.io | K3S_TOKEN=my-cluster-token \
INSTALL_K3S_EXEC="server --cluster-init --disable traefik --disable servicelb" sh -
# Join additional server nodes
curl -sfL https://get.k3s.io | K3S_TOKEN=my-cluster-token \
K3S_URL=https://10.0.0.1:6443 \
INSTALL_K3S_EXEC="server" sh -
# Install Longhorn for distributed block storage
helm repo add longhorn https://charts.longhorn.io
helm install longhorn longhorn/longhorn \
--namespace longhorn-system --create-namespace \
--set defaultSettings.defaultDataPath=/mnt/longhorn \
--set defaultSettings.replicaCount=3 \
--set defaultSettings.storageMinimalAvailablePercentage=15
# Deploy PostgreSQL with Patroni using the Zalando Postgres Operator
helm repo add postgres-operator-charts https://opensource.zalando.com/postgres-operator/charts/postgres-operator
helm install postgres-operator postgres-operator-charts/postgres-operator \
--namespace postgres-system --create-namespace# PostgreSQL cluster manifest for the Zalando Postgres Operator
apiVersion: acid.zalan.do/v1
kind: postgresql
metadata:
name: pg-ha-cluster
namespace: production
spec:
teamId: "platform"
numberOfInstances: 3
volume:
size: 500Gi
storageClass: longhorn
users:
appuser:
- superuser
- createdb
replicator: []
databases:
appdb: appuser
postgresql:
version: "16"
parameters:
shared_buffers: "16GB"
effective_cache_size: "48GB"
work_mem: "256MB"
maintenance_work_mem: "2GB"
max_connections: "200"
max_wal_senders: "10"
wal_level: replica
synchronous_commit: "on"
wal_keep_size: "2GB"
archive_mode: "on"
track_commit_timestamp: "on"
patroni:
ttl: 30
loop_wait: 10
retry_timeout: 10
maximum_lag_on_failover: 1048576
synchronous_mode: true
resources:
requests:
cpu: "4"
memory: 32Gi
limits:
cpu: "8"
memory: 64Giको HAProxy VIP
के लिए रखा गया# /etc/keepalived/keepalived.conf on lb1
vrrp_script chk_haproxy {
script "killall -0 haproxy"
interval 2
weight 2
}
vrrp_instance VI_PG {
state MASTER
interface eth0
virtual_router_id 52
priority 100
advert_int 1
authentication {
auth_type PASS
auth_pass pgha_vip_pass
}
virtual_ipaddress {
10.0.0.100/24
}
track_script {
chk_haproxy
}
}मॉनिटरिंग PostgreSQL प्रतिकृति
उत्पादन में प्रतिकृति स्वास्थ्य की निगरानी करना गैर-परक्राम्य है। PostgreSQL इस उद्देश्य के लिए कई अंतर्निहित दृश्य प्रदान करता है, और Grafana के साथ Prometheus आपको आवश्यक दीर्घकालिक दृश्यता और चेतावनी प्रदान करता है।
अंतर्निहित मॉनिटरिंग क्वेरीज़
-- Check replication status on the primary
SELECT
client_addr,
application_name,
state,
sync_state,
sent_lsn,
write_lsn,
flush_lsn,
replay_lsn,
(sent_lsn - replay_lsn) AS replication_lag_bytes,
write_lag,
flush_lag,
replay_lag
FROM pg_stat_replication;
-- Check replication slot status
SELECT
slot_name,
slot_type,
active,
wal_status,
pg_size_pretty(pg_wal_lsn_diff(pg_current_wal_lsn(), restart_lsn)) AS slot_lag
FROM pg_replication_slots;
-- Check standby recovery status (run on standby)
SELECT
pg_is_in_recovery() AS is_standby,
pg_last_wal_receive_lsn() AS last_received,
pg_last_wal_replay_lsn() AS last_replayed,
pg_last_xact_replay_timestamp() AS last_replayed_timestamp,
EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp()))::int AS replay_lag_seconds;
-- Monitor WAL generation rate
SELECT
pg_size_pretty(pg_wal_lsn_diff(pg_current_wal_lsn(), '0/0')) AS total_wal_generated,
pg_size_pretty(sum(size)) AS wal_directory_size
FROM pg_ls_waldir();
-- Check for long-running queries that could block replication
SELECT
pid,
now() - pg_stat_activity.query_start AS duration,
query,
state
FROM pg_stat_activity
WHERE (now() - pg_stat_activity.query_start) > interval '5 minutes'
AND state != 'idle'
ORDER BY duration DESC;Prometheus और Grafana स्टैक
पोस्टग्रेस_एक्सपोर्टरPostgreSQL मेट्रिक्स को Prometheus प्रारूप में प्रदर्शित करता है।संरक्षक_निर्यातकके साथ संयुक्त, आपको डेटाबेस प्रदर्शन और HA क्लस्टर स्थिति दोनों में पूर्ण दृश्यता मिलती है।
# Deploy postgres_exporter as a sidecar or standalone
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
# Custom queries for postgres_exporter
# /etc/postgres_exporter/queries.yaml
pg_replication_lag:
query: |
SELECT
CASE WHEN pg_is_in_recovery() THEN
EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp()))::float
ELSE 0 END AS lag_seconds
master: true
metrics:
- lag_seconds:
usage: "GAUGE"
description: "Replication lag in seconds"
pg_replication_slots:
query: |
SELECT
slot_name,
active::int AS active,
pg_wal_lsn_diff(pg_current_wal_lsn(), restart_lsn)::float AS slot_lag_bytes
FROM pg_replication_slots
master: true
metrics:
- slot_name:
usage: "LABEL"
- active:
usage: "GAUGE"
description: "Whether the slot is active"
- slot_lag_bytes:
usage: "GAUGE"
description: "Slot lag in bytes"# PrometheusRule for PostgreSQL HA alerts
apiVersion: monitoring.coreos.com/v1
kind: PrometheusRule
metadata:
name: postgresql-ha-alerts
namespace: monitoring
spec:
groups:
- name: postgresql-replication
rules:
- alert: PostgreSQLReplicationLagHigh
expr: pg_replication_lag_seconds > 30
for: 5m
labels:
severity: warning
annotations:
summary: "PostgreSQL replication lag exceeds 30s on {{ $labels.instance }}"
- alert: PostgreSQLReplicationSlotInactive
expr: pg_replication_slots_active == 0
for: 5m
labels:
severity: critical
annotations:
summary: "Replication slot {{ $labels.slot_name }} is inactive"
- alert: PostgreSQLReplicationSlotLagHigh
expr: pg_replication_slots_slot_lag_bytes > 1073741824
for: 10m
labels:
severity: warning
annotations:
summary: "Replication slot lag exceeds 1GB on {{ $labels.slot_name }}"
- alert: PatroniClusterUnhealthy
expr: patroni_cluster_members_count < 3
for: 2m
labels:
severity: critical
annotations:
summary: "Patroni cluster has fewer than 3 members"उत्पादन ट्यूनिंग पैरामीटर
PostgreSQL का डिफ़ॉल्ट कॉन्फ़िगरेशन रूढ़िवादी है, एक छोटे साझा होस्टिंग वातावरण के लिए ट्यून किया गया है। उत्पादन एचए क्लस्टर को प्रतिकृति, मेमोरी और वाल मापदंडों की सावधानीपूर्वक ट्यूनिंग की आवश्यकता होती है। निम्न तालिका NVMe स्टोरेज वाले 64GB रैम सर्वर के लिए सबसे महत्वपूर्ण सेटिंग्स का सारांश प्रस्तुत करती है।
# postgresql.conf — Production HA tuning
# === Replication ===
wal_level = replica
max_wal_senders = 10
max_replication_slots = 10
wal_keep_size = 4GB
synchronous_commit = on
synchronous_standby_names = 'ANY 1 (standby1, standby2)'
track_commit_timestamp = on
wal_log_hints = on
# === WAL ===
min_wal_size = 1GB
max_wal_size = 8GB
wal_buffers = 64MB
wal_compression = zstd
archive_mode = on
archive_timeout = 300
checkpoint_completion_target = 0.9
checkpoint_timeout = 15min
# === Memory ===
shared_buffers = 16GB # 25% of RAM
effective_cache_size = 48GB # 75% of RAM
work_mem = 256MB # per-operation sort/hash memory
maintenance_work_mem = 2GB # for VACUUM, CREATE INDEX
huge_pages = try
# === Connections ===
max_connections = 200 # use PgBouncer for higher client counts
superuser_reserved_connections = 5
# === Query Performance ===
random_page_cost = 1.1 # SSD storage
effective_io_concurrency = 200 # NVMe SSD
default_statistics_target = 500
jit = on
# === Logging ===
log_min_duration_statement = 500 # log queries > 500ms
log_checkpoints = on
log_connections = on
log_disconnections = on
log_lock_waits = on
log_temp_files = 0
log_autovacuum_min_duration = 0
# === Autovacuum ===
autovacuum_max_workers = 4
autovacuum_naptime = 30s
autovacuum_vacuum_cost_limit = 2000
autovacuum_vacuum_scale_factor = 0.05
autovacuum_analyze_scale_factor = 0.02ट्यूनिंग पेट्रोनी DCS पैरामीटर्स
पेट्रोनी केttl,loop_waitऔरretry_timeoutमापदंडों के बीच संबंध सीधे विफलता गति और गलत-सकारात्मक जोखिम को प्रभावित करता है। छोटे टीटीएल का मतलब तेजी से फेलओवर का पता लगाना है, लेकिन संक्षिप्त नेटवर्क ब्लिप्स के दौरान अनावश्यक फेलओवर का खतरा बढ़ जाता है।
# Conservative (production default)
ttl: 30
loop_wait: 10
retry_timeout: 10
# Failover detection: ~30-40 seconds
# Aggressive (low-latency failover)
ttl: 15
loop_wait: 5
retry_timeout: 5
# Failover detection: ~15-20 seconds
# Warning: Higher risk of false failovers in unstable networksकैओस इंजीनियरिंग और विफलता परीक्षण
एक फेलओवर सिस्टम जिसका कभी परीक्षण नहीं किया गया वह एक ऐसा सिस्टम है जो काम नहीं करता है। कैओस इंजीनियरिंग यह सत्यापित करने के लिए नियंत्रित विफलताओं को लागू करती है कि आपका HA सेटअप वास्तविक विफलता स्थितियों के तहत सही ढंग से व्यवहार करता है। प्रत्येक पेट्रोनी क्लस्टर को नियमित फेलओवर ड्रिल के अधीन किया जाना चाहिए।
फ़ेलओवर टेस्ट प्लेबुक
# 1. Verify cluster health before testing
patronictlctl -c /etc/patroni/patroni.yml list
+----------+---------+---------+----+-----------+
| Member | Host | Role | TL | Lag in MB |
+----------+---------+---------+----+-----------+
| node1 | 10.0.1.10| Leader | 5 | |
| node2 | 10.0.1.11| Replica | 5 | 0 |
| node3 | 10.0.1.12| Replica | 5 | 0 |
+----------+---------+---------+----+-----------+
# 2. Simulate primary crash (on node1)
sudo systemctl stop patroni
# Or more aggressive: sudo kill -9 $(pgrep -f patroni)
# 3. Monitor failover (from any node with patronictl)
watch -n 1 'patronictl -c /etc/patroni/patroni.yml list'
# 4. Verify new leader is elected (within 30-45 seconds)
# Expected: node2 or node3 promoted to Leader
# 5. Test write availability through HAProxy
PGPASSWORD=app_password psql -h haproxy-host -p 5000 -U appuser -d appdb \
-c "INSERT INTO health_check (ts) VALUES (now()) RETURNING *;"
# 6. Restart the former primary
sudo systemctl start patroni
# Patroni will use pg_rewind to rejoin as a replica
# 7. Verify the former primary rejoins as replica
patronictlctl -c /etc/patroni/patroni.yml listनेटवर्क विभाजन परीक्षण
# Simulate network partition on the primary using iptables
# Block all traffic to etcd from the primary
sudo iptables -A OUTPUT -d 10.0.2.10 -j DROP
sudo iptables -A OUTPUT -d 10.0.2.11 -j DROP
sudo iptables -A OUTPUT -d 10.0.2.12 -j DROP
# Expected behaviour:
# 1. Primary loses DCS access
# 2. Leader key TTL expires
# 3. Primary demotes itself (with watchdog, node may reboot)
# 4. Standby acquires leader lock and promotes
# 5. After clearing iptables rules, former primary rejoins as replica
# Clean up
sudo iptables -D OUTPUT -d 10.0.2.10 -j DROP
sudo iptables -D OUTPUT -d 10.0.2.11 -j DROP
sudo iptables -D OUTPUT -d 10.0.2.12 -j DROPटॉक्सिप्रोक्सी
के साथ स्वचालित कैओस परीक्षण# Run Toxiproxy alongside your Patroni cluster
# Create proxies for etcd and replication connections
toxiproxy-cli create etcd_proxy -l 0.0.0.0:12379 -u 10.0.2.10:2379
toxiproxy-cli create pg_repl_proxy -l 0.0.0.0:15432 -u 10.0.1.10:5432
# Add latency to etcd connections (simulates degraded network)
toxiproxy-cli toxic add etcd_proxy -t latency -a latency=500 -a jitter=200
# Add bandwidth limit to replication (simulates WAN replication)
toxiproxy-cli toxic add pg_repl_proxy -t bandwidth -a rate=1024
# Completely sever the connection (simulates network partition)
toxiproxy-cli toxic add etcd_proxy -t timeout -a timeout=0
# Monitor Patroni behaviour and verify correct failover
watch -n 2 'curl -s http://10.0.1.10:8008/patroni | python3 -m json.tool'सतत सत्यापन स्क्रिप्ट
#!/bin/bash
# continuous_ha_check.sh — Run during chaos tests to measure availability
HAPROXY_HOST="10.0.0.100"
WRITE_PORT=5000
READ_PORT=5001
DATABASE="appdb"
USER="appuser"
LOGFILE="/var/log/ha_test_$(date +%Y%m%d_%H%M%S).log"
write_count=0
write_fail=0
read_count=0
read_fail=0
while true; do
ts=$(date '+%Y-%m-%d %H:%M:%S.%3N')
# Test write path
if PGPASSWORD=app_password psql -h $HAPROXY_HOST -p $WRITE_PORT \
-U $USER -d $DATABASE -c "SELECT 1" &>/dev/null; then
((write_count++))
else
((write_fail++))
echo "$ts WRITE_FAIL total_fails=$write_fail" >> $LOGFILE
fi
# Test read path
if PGPASSWORD=app_password psql -h $HAPROXY_HOST -p $READ_PORT \
-U $USER -d $DATABASE -c "SELECT 1" &>/dev/null; then
((read_count++))
else
((read_fail++))
echo "$ts READ_FAIL total_fails=$read_fail" >> $LOGFILE
fi
total=$((write_count + write_fail))
if (( total % 100 == 0 )); then
write_avail=$(echo "scale=2; $write_count * 100 / $total" | bc)
read_total=$((read_count + read_fail))
read_avail=$(echo "scale=2; $read_count * 100 / $read_total" | bc)
echo "$ts Writes: ${write_avail}% ($write_count/$total) Reads: ${read_avail}% ($read_count/$read_total)"
fi
sleep 0.5
doneउन्नत: कैस्केडिंग प्रतिकृति और विलंबित स्टैंडबाय
बड़े समूहों के लिए, कैस्केडिंग प्रतिकृति प्राथमिक पर लोड को कम करती है। सभी स्टैंडबाय सीधे प्राथमिक से दोहराए जाने के बजाय, कुछ स्टैंडबाय अन्य स्टैंडबाय से दोहराए जाते हैं। यह एक ट्री टोपोलॉजी बनाता है जहां प्राथमिक दो स्टैंडबाय फ़ीड करता है, और वे स्टैंडबाय अतिरिक्त डाउनस्ट्रीम स्टैंडबाय फ़ीड करते हैं।
# postgresql.auto.conf on a cascading standby
primary_conninfo = 'host=standby1-host port=5432 user=replicator application_name=cascade1'
primary_slot_name = 'cascade1_slot'एकविलंबित स्टैंडबायजानबूझकर समय विलंब के साथ वाल रिकॉर्ड लागू करता है - आमतौर पर 1-4 घंटे। यह तार्किक त्रुटियों (आकस्मिक डिलीट, खराब माइग्रेशन) के खिलाफ सुरक्षा प्रदान करता है जिन्हें तुरंत सिंक्रोनस स्टैंडबाय पर दोहराया जाता है। यदि कोई आपदा आती है, तो आप विलंबित स्टैंडबाय पर वाल रीप्ले को रोक सकते हैं और त्रुटि से पहले का डेटा पुनर्प्राप्त कर सकते हैं।
# postgresql.conf on delayed standby
recovery_min_apply_delay = '1h'कनेक्शन स्ट्रिंग रणनीतियाँ
पेट्रोनी-प्रबंधित क्लस्टर से कनेक्ट होने वाले एप्लिकेशन को हमेशा HAProxy के माध्यम से कनेक्ट होना चाहिए याtarget_session_attrsके साथ PostgreSQL के अंतर्निहित मल्टी-होस्ट कनेक्शन स्ट्रिंग का उपयोग करना चाहिए। यह लोड बैलेंसर पर निर्भर हुए बिना क्लाइंट-साइड फेलओवर प्रदान करता है।
# Multi-host connection string with target_session_attrs
# The client tries each host in order and connects to the one matching the target attribute
postgresql://appuser:password@node1:5432,node2:5432,node3:5432/appdb?target_session_attrs=read-write&sslmode=require
# For read-only connections
postgresql://appuser:password@node1:5432,node2:5432,node3:5432/appdb?target_session_attrs=prefer-standby&sslmode=requireयह दृष्टिकोण उन अनुप्रयोगों के लिए अच्छा काम करता है जिन्हें HAProxy VIP को इंगित करने के लिए आसानी से पुन: कॉन्फ़िगर नहीं किया जा सकता है। PostgreSQL क्लाइंट लाइब्रेरी (libpq) फेलओवर को पारदर्शी तरीके से संभालती है।
सुरक्षा हार्डनिंग
एक उत्पादन PostgreSQL HA क्लस्टर को पारगमन और विश्राम के दौरान एन्क्रिप्शन लागू करना चाहिए, मजबूत प्रमाणीकरण का उपयोग करना चाहिए और नेटवर्क एक्सपोज़र को सीमित करना चाहिए।
# Enable TLS in postgresql.conf
ssl = on
ssl_cert_file = '/etc/postgresql/certs/server.crt'
ssl_key_file = '/etc/postgresql/certs/server.key'
ssl_ca_file = '/etc/postgresql/certs/ca.crt'
ssl_min_protocol_version = 'TLSv1.3'
# Require TLS for all connections in pg_hba.conf
hostssl replication replicator 10.0.0.0/16 scram-sha-256
hostssl all all 10.0.0.0/16 scram-sha-256
# etcd TLS
# In Patroni config
etcd3:
hosts:
- 10.0.2.10:2379
- 10.0.2.11:2379
- 10.0.2.12:2379
protocol: https
cacert: /etc/patroni/certs/etcd-ca.crt
cert: /etc/patroni/certs/etcd-client.crt
key: /etc/patroni/certs/etcd-client.keyHA क्लस्टर्सके लिएबैकअप रणनीति
पेट्रोनी क्लस्टर के लिए एक व्यापक बैकअप रणनीति में निरंतर वाल संग्रह, नियमित पूर्ण बैकअप और पूर्ण बैकअप के बीच अंतर या वृद्धिशील बैकअप शामिल होना चाहिए। pgBackRest उत्पादन PostgreSQL बैकअप प्रबंधन के लिए अनुशंसित उपकरण है।
# Schedule backups via cron
# Full backup weekly (Sunday 2 AM)
0 2 * * 0 pgbackrest --stanza=pg-ha-cluster --type=full backup
# Differential backup daily (2 AM, Mon-Sat)
0 2 * * 1-6 pgbackrest --stanza=pg-ha-cluster --type=diff backup
# Verify backup integrity
pgbackrest --stanza=pg-ha-cluster --set=latest info
# Verify backup can be restored (dry run)
pgbackrest --stanza=pg-ha-cluster --set=latest verify
# List all backups
pgbackrest --stanza=pg-ha-cluster info
full backup: 20260412-020000F
timestamp: 2026-04-12 02:00:00 +0000
wal start/stop: 000000050000000000000040 / 000000050000000000000042
database size: 150GB, backup size: 150GB
repository size: 45GB (compressed)
diff backup: 20260412-020000F_20260413-020000D
timestamp: 2026-04-13 02:00:00 +0000
database size: 151GB, backup size: 2.1GB
repository size: 650MB (compressed)परिचालन रनबुक सारांश
पेट्रोनी क्लस्टर चलाने वाली प्रत्येक टीम को निम्नलिखित परिदृश्यों को कवर करते हुए एक रनबुक बनाए रखना चाहिए। प्रलेखित, परीक्षणित प्रक्रियाएं एक तनावपूर्ण आउटेज को एक नियमित ऑपरेशन में बदल देती हैं।
# === Quick Reference Commands ===
# Cluster status
patronictlctl -c /etc/patroni/patroni.yml list
patronictlctl -c /etc/patroni/patroni.yml history
# Planned switchover
patronictlctl -c /etc/patroni/patroni.yml switchover --master node1 --candidate node2
# Restart PostgreSQL on a specific node (rolling restart)
patronictlctl -c /etc/patroni/patroni.yml restart pg-ha-cluster node2
# Reload PostgreSQL configuration without restart
patronictlctl -c /etc/patroni/patroni.yml reload pg-ha-cluster
# Pause automatic failover (during maintenance)
patronictlctl -c /etc/patroni/patroni.yml pause
# Resume automatic failover
patronictlctl -c /etc/patroni/patroni.yml resume
# Edit DCS configuration (applies to all nodes)
patronictlctl -c /etc/patroni/patroni.yml edit-config
# Reinitialise a failed replica
patronictlctl -c /etc/patroni/patroni.yml reinit pg-ha-cluster node3
# Check Patroni REST API directly
curl -s http://10.0.1.10:8008/patroni | python3 -m json.tool
curl -s http://10.0.1.10:8008/cluster | python3 -m json.toolप्रदर्शन बेंचमार्किंग
उत्पादन पर जाने से पहले, बेसलाइन प्रदर्शन स्थापित करने के लिए अपने HA क्लस्टर को बेंचमार्क करें और सत्यापित करें कि सिंक्रोनस प्रतिकृति विलंबता आपके कार्यभार के लिए स्वीकार्य है।
# Benchmark with pgbench — initialise test data
pgbench -i -s 100 -h haproxy-host -p 5000 -U appuser appdb
# Run write-heavy benchmark (measures sync replication impact)
pgbench -h haproxy-host -p 5000 -U appuser -c 32 -j 8 -T 300 appdb
# Compare with async: temporarily set synchronous_commit = off
# Run read-only benchmark through read replica port
pgbench -h haproxy-host -p 5001 -U appuser -c 64 -j 16 -T 300 -S appdb
# Measure failover impact on transactions
# Run pgbench in background, then trigger a failover
pgbench -h haproxy-host -p 5000 -U appuser -c 8 -j 4 -T 600 appdb &
sleep 60 && patronictl switchover --master node1 --candidate node2 --forceनिष्कर्ष
पेट्रोनी के साथPostgreSQL मूल उच्च उपलब्धता एक एकल-टूल समाधान नहीं है - यह स्ट्रीमिंग प्रतिकृति, वितरित सर्वसम्मति, कनेक्शन रूटिंग, कनेक्शन पूलिंग, वाल संग्रह, निगरानी और परिचालन अनुशासन की एक एकीकृत प्रणाली है। प्रत्येक परत एक विशिष्ट विफलता मोड को संबोधित करती है: स्ट्रीमिंग प्रतिकृति डेटा अतिरेक को संभालती है, पेट्रोनी स्वचालित विफलता समन्वय को संभालती है, आदि विभाजन-मस्तिष्क के बिना नेता चुनाव के लिए आवश्यक वितरित सर्वसम्मति प्रदान करती है, HAProxy सही नेता के लिए कनेक्शन रूट करता है, PgBouncer बड़े पैमाने पर कनेक्शन ओवरहेड का प्रबंधन करता है, और pgBackRest के साथ WAL संग्रह तार्किक त्रुटियों और आपदा वसूली के खिलाफ रक्षा की अंतिम पंक्ति प्रदान करता है।
परिनियोजन पैटर्न वातावरण में अलग-अलग होते हैं - NLB और Route53 के साथ AWS, उपलब्धता क्षेत्र और Azure लोड बैलेंसर के साथ Azure, क्षेत्रीय प्रबंधित इंस्टेंस समूहों के साथ GCP, या k3s, लॉन्गहॉर्न और कीपलिवेड के साथ बेयर मेटल - लेकिन मुख्य आर्किटेक्चर वही रहता है। पैट्रोनी द्वारा प्रबंधित तीन या अधिक PostgreSQL नोड्स, एक तीन-नोड आदि क्लस्टर द्वारा समर्थित, एक लोड बैलेंसर के सामने जो पैट्रोनी के स्वास्थ्य जांच समापन बिंदुओं का अनुसरण करता है।
सबसे महत्वपूर्ण निवेश जो आप कर सकते हैं वह कॉन्फ़िगरेशन में नहीं है - यह परीक्षण में है। मासिक रूप से फेलओवर अभ्यास चलाएँ। नेटवर्क विभाजन इंजेक्ट करें. प्रक्रियाओं को अप्रत्याशित रूप से समाप्त करें. पुनर्प्राप्ति समय और डेटा हानि को मापें। ऐसे डैशबोर्ड बनाएं जो वास्तविक समय में प्रतिकृति अंतराल, वाल पीढ़ी दर, कनेक्शन पूल संतृप्ति और डीसीएस स्वास्थ्य दिखाएं। व्यवस्थित परीक्षण से आपको जो आत्मविश्वास प्राप्त होता है, वह उस क्लस्टर को अलग करता है जो अपने पहले वास्तविक आउटेज से बच जाता है, जो सर्वर विफलता को व्यवसाय-प्रभावित करने वाली घटना में बदल देता है।
PostgreSQL आपको सभी प्रतिकृति आदिम देता है। पेट्रोनी आपको आर्केस्ट्रा देता है। इत्यादि आपको सर्वसम्मति प्रदान करता है। आपका काम उन्हें सही ढंग से एक साथ जोड़ना, उन्हें अपने कार्यभार के अनुसार समायोजित करना और उन्हें लगातार मान्य करना है। इस गाइड ने आपको ब्लूप्रिंट दिए हैं - अब आत्मविश्वास के साथ निर्माण, परीक्षण और संचालन करें।