@xdev-asia/xdev-knowledge-mcp 1.0.36

package/content/blog/devops/huong-dan-upgrade-postgresql-17-6-len-18-1-chuan-production.md

@@ -0,0 +1,482 @@
+---
+id: 019c9617-fd8a-7311-bebd-480161450db5
+title: Hướng Dẫn Upgrade PostgreSQL 17.6 lên 18.1 (Chuẩn Production)
+slug: huong-dan-upgrade-postgresql-17-6-len-18-1-chuan-production
+excerpt: >-
+  Hướng dẫn chi tiết upgrade PostgreSQL 17.6 lên 18.1 cho môi trường production
+  với downtime tối thiểu. Bao gồm pg_upgrade, logical replication, rollback
+  plan, và các best practices được cập nhật cho PostgreSQL 18 với Async I/O,
+  Statistics Preservation, và pg_upgrade --swap mode mới.
+featured_image: /images/blog/postgresql-upgrade-featured.png
+type: blog
+reading_time: 15
+view_count: 0
+meta: null
+published_at: '2025-12-23T05:02:11.000000Z'
+created_at: '2026-02-25T18:38:00.000000Z'
+author:
+  id: 019c9616-d2b4-713f-9b2c-40e2e92a05cf
+  name: Duy Tran
+  avatar: avatars/7e8eb5c6-4cac-455b-a701-4060f085d501.jpeg
+category:
+  id: 019c9617-faa6-70d6-8679-ee4de1f177b3
+  name: DevOps
+  slug: devops
+tags:
+  - name: postgresql
+    slug: postgresql
+  - name: devops
+    slug: devops
+  - name: linux
+    slug: linux
+  - name: production
+    slug: production
+  - name: Database
+    slug: database
+  - name: PostgreSQL 18
+    slug: postgresql-18
+  - name: Database Migration
+    slug: database-migration
+  - name: pg_upgrade
+    slug: pg-upgrade
+  - name: System Administration
+    slug: system-administration
+comments: []
+---
+<hr><p>PostgreSQL 18 chính thức ra mắt vào ngày 25/9/2025, đánh dấu một trong những bản release quan trọng nhất trong lịch sử PostgreSQL. Với việc giới thiệu <strong>Asynchronous I/O subsystem</strong>, hiệu năng đọc từ storage được cải thiện lên đến <strong>3 lần</strong>, cùng nhiều tính năng mới như <strong>UUIDv7</strong>, <strong>Virtual Generated Columns</strong>, và <strong>OAuth 2.0 authentication</strong>.</p><p>Bài viết này sẽ hướng dẫn chi tiết cách upgrade từ PostgreSQL 17.6 lên 18.1 theo chuẩn production, đảm bảo <strong>downtime tối thiểu</strong> và <strong>rollback an toàn</strong>.</p><hr><h2 id="1-t%E1%BA%A1i-sao-n%C3%AAn-upgrade-l%C3%AAn-postgresql-18">1. Tại Sao Nên Upgrade Lên PostgreSQL 18?</h2><h3 id="11-c%C3%A1c-t%C3%ADnh-n%C4%83ng-n%E1%BB%95i-b%E1%BA%ADt">1.1. Các Tính Năng Nổi Bật</h3>
+<!--kg-card-begin: html-->
+<table>
+<thead>
+<tr>
+<th>Tính năng</th>
+<th>Mô tả</th>
+<th>Lợi ích</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Asynchronous I/O</strong></td>
+<td>Hệ thống I/O bất đồng bộ mới</td>
+<td>Tăng tốc sequential scan, bitmap heap scan lên đến 3x</td>
+</tr>
+<tr>
+<td><strong>Statistics Preservation</strong></td>
+<td>Giữ lại planner statistics khi upgrade</td>
+<td>Không cần chạy ANALYZE sau upgrade</td>
+</tr>
+<tr>
+<td><strong>Skip Scan</strong></td>
+<td>Lookup trên multicolumn B-tree indexes</td>
+<td>Query nhanh hơn khi bỏ qua điều kiện <code>=</code> trên prefix columns</td>
+</tr>
+<tr>
+<td><strong>UUIDv7</strong></td>
+<td>Native <code>uuidv7()</code> function</td>
+<td>UUID có timestamp, tốt hơn cho indexing</td>
+</tr>
+<tr>
+<td><strong>Virtual Generated Columns</strong></td>
+<td>Computed columns tại query time</td>
+<td>Linh hoạt hơn trong schema design</td>
+</tr>
+<tr>
+<td><strong>OAuth 2.0</strong></td>
+<td>Authentication với identity providers</td>
+<td>Tích hợp SSO dễ dàng</td>
+</tr>
+<tr>
+<td><strong>pg_upgrade --swap</strong></td>
+<td>Chế độ swap mới</td>
+<td>Upgrade nhanh hơn, không cần copy files</td>
+</tr>
+</tbody>
+</table>
+<!--kg-card-end: html-->
+<h3 id="12-breaking-changes-c%E1%BA%A7n-l%C6%B0u-%C3%BD">1.2. Breaking Changes Cần Lưu Ý</h3><pre><code class="language-text">⚠️ QUAN TRỌNG - Các thay đổi không tương thích ngược:
+
+1. Data Checksums mặc định BẬT (initdb)
+   - Cần matching checksum settings khi pg_upgrade
+   
+2. MD5 authentication DEPRECATED
+   - Nên migrate sang SCRAM-SHA-256
+   
+3. Time zone abbreviation handling thay đổi
+   - Session timezone được ưu tiên trước timezone_abbreviations
+</code></pre><hr><h2 id="2-chu%E1%BA%A9n-b%E1%BB%8B-tr%C6%B0%E1%BB%9Bc-khi-upgrade">2. Chuẩn Bị Trước Khi Upgrade</h2><h3 id="21-checklist-pre-upgrade">2.1. Checklist Pre-Upgrade</h3><pre><code class="language-bash">#!/bin/bash
+# pre-upgrade-checklist.sh
+
+echo "=== PostgreSQL Upgrade Checklist ==="
+
+# 1. Kiểm tra version hiện tại
+echo "1. Current PostgreSQL Version:"
+psql -c "SELECT version();"
+
+# 2. Kiểm tra disk space
+echo "2. Disk Space (cần ít nhất 2x data directory size):"
+df -h /var/lib/postgresql
+
+# 3. Kiểm tra data directory size
+echo "3. Data Directory Size:"
+du -sh /var/lib/postgresql/17/main
+
+# 4. Kiểm tra checksum status
+echo "4. Data Checksum Status:"
+pg_controldata /var/lib/postgresql/17/main | grep "Data page checksum"
+
+# 5. Kiểm tra extensions
+echo "5. Installed Extensions:"
+psql -c "SELECT extname, extversion FROM pg_extension ORDER BY extname;"
+
+# 6. Kiểm tra replication slots
+echo "6. Replication Slots:"
+psql -c "SELECT slot_name, slot_type, active FROM pg_replication_slots;"
+
+# 7. Kiểm tra prepared transactions
+echo "7. Prepared Transactions (should be empty):"
+psql -c "SELECT * FROM pg_prepared_xacts;"
+</code></pre><h3 id="22-backup-strategy">2.2. Backup Strategy</h3><p><strong>QUAN TRỌNG:</strong> Luôn backup trước khi upgrade!</p><pre><code class="language-bash"># 1. Full backup với pg_dumpall (logical backup)
+pg_dumpall -U postgres -h localhost -f /backup/full_backup_$(date +%Y%m%d).sql
+
+# 2. Base backup (physical backup) - khuyến nghị
+pg_basebackup -D /backup/basebackup_$(date +%Y%m%d) \
+  -Ft -z -P \
+  -U replication \
+  -h localhost
+
+# 3. Backup configuration files
+cp /etc/postgresql/17/main/postgresql.conf /backup/
+cp /etc/postgresql/17/main/pg_hba.conf /backup/
+cp /etc/postgresql/17/main/pg_ident.conf /backup/
+</code></pre><h3 id="23-c%C3%A0i-%C4%91%E1%BA%B7t-postgresql-181">2.3. Cài Đặt PostgreSQL 18.1</h3><pre><code class="language-bash"># Ubuntu/Debian
+sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" &gt; /etc/apt/sources.list.d/pgdg.list'
+wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
+sudo apt-get update
+sudo apt-get install postgresql-18
+
+# RHEL/Rocky Linux
+sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm
+sudo dnf -qy module disable postgresql
+sudo dnf install -y postgresql18-server postgresql18-contrib
+</code></pre><hr><h2 id="3-c%C3%A1c-ph%C6%B0%C6%A1ng-ph%C3%A1p-upgrade">3. Các Phương Pháp Upgrade</h2><h3 id="31-so-s%C3%A1nh-c%C3%A1c-ph%C6%B0%C6%A1ng-ph%C3%A1p">3.1. So Sánh Các Phương Pháp</h3>
+<!--kg-card-begin: html-->
+<table>
+<thead>
+<tr>
+<th>Phương pháp</th>
+<th>Downtime</th>
+<th>Use Case</th>
+<th>Độ phức tạp</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>pg_upgrade</strong></td>
+<td>Phút</td>
+<td>Same host, brief pause</td>
+<td>Thấp</td>
+</tr>
+<tr>
+<td><strong>pg_upgrade --link</strong></td>
+<td>Giây - Phút</td>
+<td>Same filesystem, nhanh nhất</td>
+<td>Thấp</td>
+</tr>
+<tr>
+<td><strong>pg_upgrade --swap</strong> (PG18 mới)</td>
+<td>Giây - Phút</td>
+<td>Swap directories</td>
+<td>Thấp</td>
+</tr>
+<tr>
+<td><strong>Logical Replication</strong></td>
+<td>Giây</td>
+<td>24x7 apps, zero-downtime</td>
+<td>Cao</td>
+</tr>
+<tr>
+<td><strong>pg_dump/restore</strong></td>
+<td>Giờ - Ngày</td>
+<td>Small DBs, cross-platform</td>
+<td>Thấp</td>
+</tr>
+</tbody>
+</table>
+<!--kg-card-end: html-->
+<h3 id="32-khuy%E1%BA%BFn-ngh%E1%BB%8B-cho-production">3.2. Khuyến Nghị Cho Production</h3><pre><code>┌─────────────────────────────────────────────────────────────┐
+│                    DECISION FLOWCHART                        │
+├─────────────────────────────────────────────────────────────┤
+│                                                              │
+│  Database size &lt; 100GB?                                      │
+│     YES → pg_upgrade --link hoặc --swap                     │
+│     NO  ↓                                                   │
+│                                                              │
+│  Zero-downtime required?                                     │
+│     YES → Logical Replication                                │
+│     NO  → pg_upgrade --link với maintenance window           │
+│                                                              │
+│  Cross-platform migration?                                   │
+│     YES → pg_dump/restore                                    │
+│                                                              │
+└─────────────────────────────────────────────────────────────┘
+</code></pre><hr><h2 id="4-upgrade-v%E1%BB%9Bi-pgupgrade-recommended">4. Upgrade Với pg_upgrade (Recommended)</h2><h3 id="41-kh%E1%BB%9Fi-t%E1%BA%A1o-cluster-m%E1%BB%9Bi">4.1. Khởi Tạo Cluster Mới</h3><pre><code class="language-bash"># Tạo data directory cho PostgreSQL 18
+sudo mkdir -p /var/lib/postgresql/18/main
+sudo chown postgres:postgres /var/lib/postgresql/18/main
+
+# Chuyển sang user postgres
+sudo -i -u postgres
+
+# Kiểm tra checksum của cluster cũ
+pg_controldata /var/lib/postgresql/17/main | grep "Data page checksum"
+# Output: Data page checksum version: 0 (disabled) hoặc 1 (enabled)
+
+# Init cluster mới với MATCHING checksum setting
+# Nếu cluster cũ KHÔNG có checksum:
+/usr/lib/postgresql/18/bin/initdb \
+  -D /var/lib/postgresql/18/main \
+  --no-data-checksums \
+  --encoding=UTF8 \
+  --locale=en_US.UTF-8
+
+# Nếu cluster cũ CÓ checksum (hoặc muốn enable):
+/usr/lib/postgresql/18/bin/initdb \
+  -D /var/lib/postgresql/18/main \
+  --data-checksums \
+  --encoding=UTF8 \
+  --locale=en_US.UTF-8
+</code></pre><h3 id="42-pre-upgrade-check">4.2. Pre-Upgrade Check</h3><pre><code class="language-bash"># Set environment variables
+export PGBINOLD=/usr/lib/postgresql/17/bin
+export PGBINNEW=/usr/lib/postgresql/18/bin
+export PGDATAOLD=/var/lib/postgresql/17/main
+export PGDATANEW=/var/lib/postgresql/18/main
+
+# Chạy check mode TRƯỚC
+/usr/lib/postgresql/18/bin/pg_upgrade \
+  --old-datadir=$PGDATAOLD \
+  --new-datadir=$PGDATANEW \
+  --old-bindir=$PGBINOLD \
+  --new-bindir=$PGBINNEW \
+  --check
+
+# Expected output:
+# Performing Consistency Checks
+# -----------------------------
+# Checking cluster versions                         ok
+# Checking database connection settings             ok
+# Checking database user is the install user        ok
+# Checking for prepared transactions                ok
+# ...
+# *Clusters are compatible*
+</code></pre><h3 id="43-stop-services-upgrade">4.3. Stop Services &amp; Upgrade</h3><pre><code class="language-bash"># 1. Stop ứng dụng kết nối đến database
+# (tùy thuộc vào setup của bạn)
+
+# 2. Stop PostgreSQL 17
+sudo systemctl stop postgresql@17-main
+
+# 3. Verify PostgreSQL 17 đã stop
+pg_isready -p 5432
+# Output: no response
+
+# 4. Thực hiện upgrade với --link mode (nhanh nhất)
+cd /var/lib/postgresql
+/usr/lib/postgresql/18/bin/pg_upgrade \
+  --old-datadir=$PGDATAOLD \
+  --new-datadir=$PGDATANEW \
+  --old-bindir=$PGBINOLD \
+  --new-bindir=$PGBINNEW \
+  --link \
+  --jobs=$(nproc)
+
+# Hoặc với --swap mode (PostgreSQL 18 mới)
+/usr/lib/postgresql/18/bin/pg_upgrade \
+  --old-datadir=$PGDATAOLD \
+  --new-datadir=$PGDATANEW \
+  --old-bindir=$PGBINOLD \
+  --new-bindir=$PGBINNEW \
+  --swap \
+  --jobs=$(nproc)
+</code></pre><h3 id="44-copy-configuration-files">4.4. Copy Configuration Files</h3><pre><code class="language-bash"># Copy các config files từ cluster cũ
+cp /etc/postgresql/17/main/postgresql.conf /etc/postgresql/18/main/
+cp /etc/postgresql/17/main/pg_hba.conf /etc/postgresql/18/main/
+cp /etc/postgresql/17/main/pg_ident.conf /etc/postgresql/18/main/
+
+# Hoặc nếu dùng data directory cho config
+cp $PGDATAOLD/postgresql.conf $PGDATANEW/
+cp $PGDATAOLD/pg_hba.conf $PGDATANEW/
+
+# Cập nhật port trong postgresql.conf nếu cần
+# (nếu muốn chạy song song cả 2 version)
+sed -i 's/port = 5432/port = 5433/' /etc/postgresql/18/main/postgresql.conf
+</code></pre><h3 id="45-start-postgresql-18-verify">4.5. Start PostgreSQL 18 &amp; Verify</h3><pre><code class="language-bash"># Start PostgreSQL 18
+sudo systemctl start postgresql@18-main
+
+# Verify connection
+psql -p 5432 -c "SELECT version();"
+# Output: PostgreSQL 18.1 on x86_64-pc-linux-gnu...
+
+# Verify databases
+psql -c "\l"
+
+# Verify table counts (sample)
+psql -d your_database -c "SELECT schemaname, COUNT(*) FROM pg_tables GROUP BY schemaname;"
+</code></pre><hr><h2 id="5-post-upgrade-tasks">5. Post-Upgrade Tasks</h2><h3 id="51-statistics-handling-postgresql-18-t%E1%BB%B1-%C4%91%E1%BB%99ng-preserve">5.1. Statistics Handling (PostgreSQL 18 tự động preserve)</h3><pre><code class="language-bash"># PostgreSQL 18 tự động preserve statistics!
+# Chỉ cần chạy cho extended statistics nếu có:
+
+/usr/lib/postgresql/18/bin/vacuumdb \
+  --all \
+  --analyze-in-stages \
+  --missing-stats-only
+
+# Hoặc chạy đầy đủ nếu muốn
+vacuumdb --all --analyze
+</code></pre><h3 id="52-extension-updates">5.2. Extension Updates</h3><pre><code class="language-bash"># Kiểm tra extensions cần update
+psql -c "SELECT * FROM pg_extension WHERE extversion != (SELECT default_version FROM pg_available_extensions WHERE name = extname);"
+
+# Update tất cả extensions
+psql -c "SELECT format('ALTER EXTENSION %I UPDATE;', extname) FROM pg_extension;" | psql
+
+# Hoặc update từng extension
+psql -c "ALTER EXTENSION pg_stat_statements UPDATE;"
+psql -c "ALTER EXTENSION postgis UPDATE;"
+</code></pre><h3 id="53-cleanup">5.3. Cleanup</h3><pre><code class="language-bash"># Xóa cluster cũ (CHỈ SAU KHI VERIFY HOÀN TẤT!)
+# pg_upgrade tạo script delete_old_cluster.sh
+./delete_old_cluster.sh
+
+# Hoặc thủ công
+rm -rf /var/lib/postgresql/17/main
+
+# Disable PostgreSQL 17 service
+sudo systemctl disable postgresql@17-main
+</code></pre><h3 id="54-performance-validation">5.4. Performance Validation</h3><pre><code class="language-sql">-- Kiểm tra query plan của các query quan trọng
+EXPLAIN (ANALYZE, BUFFERS, VERBOSE) 
+SELECT * FROM your_critical_table WHERE your_condition;
+
+-- So sánh với baseline trước upgrade
+-- Lưu ý: PostgreSQL 18 EXPLAIN ANALYZE tự động include BUFFERS
+
+-- Kiểm tra AIO settings (PostgreSQL 18)
+SHOW io_method;
+-- Output: io_uring (Linux) hoặc worker
+
+-- Monitor với pg_stat_io (mới trong PG16, cải thiện PG18)
+SELECT * FROM pg_stat_io WHERE reads &gt; 0;
+</code></pre><hr><h2 id="6-upgrade-v%E1%BB%9Bi-logical-replication-zero-downtime">6. Upgrade Với Logical Replication (Zero-Downtime)</h2><h3 id="61-t%E1%BB%95ng-quan-architecture">6.1. Tổng Quan Architecture</h3><pre><code>┌──────────────────────┐         ┌──────────────────────┐
+│   PostgreSQL 17.6    │         │   PostgreSQL 18.1    │
+│     (Publisher)      │  ─────► │    (Subscriber)      │
+│   Primary/Source     │   WAL   │   Target/Replica     │
+│     Port: 5432       │         │     Port: 5433       │
+└──────────────────────┘         └──────────────────────┘
+                                          │
+                                          ▼
+                                   Cutover (DNS/HAProxy)
+</code></pre><h3 id="62-setup-publisher-postgresql-17">6.2. Setup Publisher (PostgreSQL 17)</h3><pre><code class="language-sql">-- 1. Enable logical replication trong postgresql.conf
+-- wal_level = logical
+-- max_replication_slots = 10
+-- max_wal_senders = 10
+
+-- 2. Tạo publication
+CREATE PUBLICATION pg18_migration FOR ALL TABLES;
+
+-- 3. Tạo replication user
+CREATE USER repl_user WITH REPLICATION PASSWORD 'secure_password';
+GRANT SELECT ON ALL TABLES IN SCHEMA public TO repl_user;
+
+-- 4. Cập nhật pg_hba.conf
+-- host    all    repl_user    subscriber_ip/32    scram-sha-256
+-- host    replication    repl_user    subscriber_ip/32    scram-sha-256
+</code></pre><h3 id="63-setup-subscriber-postgresql-18">6.3. Setup Subscriber (PostgreSQL 18)</h3><pre><code class="language-bash"># 1. Dump schema only (không data)
+pg_dump -h old_server -U postgres -s -d your_db &gt; schema.sql
+
+# 2. Restore schema vào PostgreSQL 18
+psql -d your_db -f schema.sql
+</code></pre><pre><code class="language-sql">-- 3. Tạo subscription
+CREATE SUBSCRIPTION pg18_sub
+CONNECTION 'host=old_server port=5432 dbname=your_db user=repl_user password=secure_password'
+PUBLICATION pg18_migration;
+
+-- 4. Monitor sync progress
+SELECT * FROM pg_stat_subscription;
+SELECT * FROM pg_subscription_rel;
+
+-- 5. Kiểm tra lag
+SELECT 
+  slot_name,
+  pg_size_pretty(pg_wal_lsn_diff(pg_current_wal_lsn(), confirmed_flush_lsn)) as lag
+FROM pg_replication_slots;
+</code></pre><h3 id="64-cutover-process">6.4. Cutover Process</h3><pre><code class="language-bash">#!/bin/bash
+# cutover.sh - Zero-downtime cutover script
+
+echo "=== Starting Cutover Process ==="
+
+# 1. Stop writes to old server (application level)
+echo "1. Stopping application writes..."
+# kubectl scale deployment/app --replicas=0
+# hoặc update HAProxy/PgBouncer
+
+# 2. Wait for replication to catch up
+echo "2. Waiting for replication lag to be 0..."
+while true; do
+  LAG=$(psql -h new_server -p 5433 -t -c \
+    "SELECT pg_wal_lsn_diff(pg_current_wal_lsn(), confirmed_flush_lsn) FROM pg_replication_slots WHERE slot_name='pg18_sub'")
+  if [ "$LAG" -eq 0 ]; then
+    break
+  fi
+  sleep 1
+done
+
+# 3. Disable subscription
+echo "3. Disabling subscription..."
+psql -h new_server -p 5433 -c "ALTER SUBSCRIPTION pg18_sub DISABLE;"
+psql -h new_server -p 5433 -c "DROP SUBSCRIPTION pg18_sub;"
+
+# 4. Reset sequences (quan trọng!)
+echo "4. Resetting sequences..."
+psql -h new_server -p 5433 -c "SELECT setval(c.oid, s.last_value) FROM pg_class c JOIN pg_sequences s ON c.relname = s.sequencename WHERE s.last_value IS NOT NULL;"
+
+# 5. Switch traffic to new server
+echo "5. Switching traffic..."
+# Update DNS, HAProxy, PgBouncer, etc.
+
+echo "=== Cutover Complete ==="
+</code></pre><hr><h2 id="7-rollback-plan">7. Rollback Plan</h2><h3 id="71-rollback-t%E1%BB%AB-pgupgradelink">7.1. Rollback Từ pg_upgrade --link</h3><pre><code class="language-bash"># QUAN TRỌNG: Với --link mode, bạn KHÔNG THỂ rollback sau khi start cluster mới!
+# Do đó, LUÔN test kỹ trước khi start
+
+# Nếu chưa start PostgreSQL 18:
+# Chỉ cần start lại PostgreSQL 17
+sudo systemctl start postgresql@17-main
+</code></pre><h3 id="72-rollback-t%E1%BB%AB-pgupgradecopy">7.2. Rollback Từ pg_upgrade --copy</h3><pre><code class="language-bash"># Nếu dùng --copy mode, cluster cũ vẫn còn nguyên
+# Chỉ cần switch về cluster cũ
+
+sudo systemctl stop postgresql@18-main
+sudo systemctl start postgresql@17-main
+</code></pre><h3 id="73-rollback-t%E1%BB%AB-logical-replication">7.3. Rollback Từ Logical Replication</h3><pre><code class="language-sql">-- Trên subscriber (PostgreSQL 18)
+ALTER SUBSCRIPTION pg18_sub DISABLE;
+DROP SUBSCRIPTION pg18_sub;
+
+-- Switch traffic về PostgreSQL 17
+-- Update DNS/HAProxy/PgBouncer
+</code></pre><hr><h2 id="8-monitoring-troubleshooting">8. Monitoring &amp; Troubleshooting</h2><h3 id="81-monitoring-script">8.1. Monitoring Script</h3><pre><code class="language-bash">#!/bin/bash
+# monitor-upgrade.sh
+
+echo "=== PostgreSQL 18 Health Check ==="
+
+# 1. Version
+psql -c "SELECT version();"
+
+# 2. Uptime
+psql -c "SELECT pg_postmaster_start_time(), now() - pg_postmaster_start_time() as uptime;"
+
+# 3. Active connections
+psql -c "SELECT count(*) as active_connections FROM pg_stat_activity WHERE state = 'active';"
+
+# 4. Database sizes
+psql -c "SELECT datname, pg_size_pretty(pg_database_size(datname)) FROM pg_database ORDER BY pg_database_size(datname) DESC;"
+
+# 5. Long running queries
+psql -c "SELECT pid, now() - pg_stat_activity.query_start AS duration, query FROM pg_stat_activity WHERE state = 'active' AND now() - pg_stat_activity.query_start &gt; interval '5 minutes';"
+
+# 6. Replication status (if applicable)
+psql -c "SELECT * FROM pg_stat_replication;"
+
+# 7. I/O statistics (PostgreSQL 18)
+psql -c "SELECT backend_type, reads, writes, extends FROM pg_stat_io WHERE reads &gt; 0 OR writes &gt; 0;"
+</code></pre><h2 id="9-best-practices-summary">9. Best Practices Summary</h2><h3 id="91-pre-upgrade">9.1. Pre-Upgrade</h3><ul><li>[ ] Đọc kỹ <a href="https://www.postgresql.org/docs/18/release-18.html">Release Notes PostgreSQL 18</a></li><li>[ ] Test upgrade trên staging/development environment</li><li>[ ] Backup đầy đủ (logical + physical)</li><li>[ ] Document rollback plan</li><li>[ ] Notify stakeholders về maintenance window</li><li>[ ] Kiểm tra compatibility của tất cả extensions</li></ul><h3 id="92-during-upgrade">9.2. During Upgrade</h3><ul><li>[ ] Sử dụng <code>pg_upgrade --check</code> trước khi upgrade thực sự</li><li>[ ] Monitor disk space trong quá trình upgrade</li><li>[ ] Giữ terminal session với <code>screen</code> hoặc <code>tmux</code></li><li>[ ] Log tất cả output để troubleshoot</li></ul><h3 id="93-post-upgrade">9.3. Post-Upgrade</h3><ul><li>[ ] Verify data integrity</li><li>[ ] Test critical queries và so sánh với baseline</li><li>[ ] Update extensions</li><li>[ ] Monitor performance 24-48 giờ</li><li>[ ] Cleanup old cluster sau khi verify hoàn tất</li><li>[ ] Update documentation và runbooks</li></ul><hr><h2 id="10-k%E1%BA%BFt-lu%E1%BA%ADn">10. Kết Luận</h2><p>PostgreSQL 18 mang đến nhiều cải tiến đáng giá, đặc biệt là <strong>Asynchronous I/O</strong> và <strong>Statistics Preservation</strong> giúp upgrade mượt mà hơn bao giờ hết. Với việc lập kế hoạch kỹ càng và follow đúng quy trình, bạn có thể upgrade production database với <strong>downtime tối thiểu</strong> và <strong>risk thấp</strong>.</p><p><strong>Tài liệu tham khảo:</strong></p><ul><li><a href="https://www.postgresql.org/docs/18/release-18.html">PostgreSQL 18 Release Notes</a></li><li><a href="https://www.postgresql.org/docs/current/pgupgrade.html">pg_upgrade Documentation</a></li><li><a href="https://www.postgresql.org/docs/current/upgrading.html">Upgrading PostgreSQL Cluster</a></li></ul><hr><p><em>Nếu bài viết hữu ích, hãy chia sẻ và để lại comment bên dưới! 👇</em></p>

package/content/blog/devops/xay-dung-postgresql-high-availability-cluster-voi-ansible.md

@@ -0,0 +1,105 @@
+---
+id: 019c9617-fd06-7322-b055-2e68380e39b2
+title: Xây Dựng PostgreSQL High Availability Cluster với Ansible
+slug: xay-dung-postgresql-high-availability-cluster-voi-ansible
+excerpt: >-
+  Chia sẻ kinh nghiệm triển khai và open-source giải pháp PostgreSQL HA cluster
+  tự động hóa hoàn toàn
+featured_image: /images/blog/postgresql-ha-featured.png
+type: blog
+reading_time: 14
+view_count: 1
+meta: null
+published_at: '2025-11-25T16:47:20.000000Z'
+created_at: '2026-02-25T18:38:00.000000Z'
+author:
+  id: 019c9616-d2b4-713f-9b2c-40e2e92a05cf
+  name: Duy Tran
+  avatar: avatars/7e8eb5c6-4cac-455b-a701-4060f085d501.jpeg
+category:
+  id: 019c9617-faa6-70d6-8679-ee4de1f177b3
+  name: DevOps
+  slug: devops
+tags:
+  - name: postgresql
+    slug: postgresql
+  - name: patroni
+    slug: patroni
+  - name: etcd
+    slug: etcd
+  - name: devops
+    slug: devops
+  - name: cicd
+    slug: cicd
+  - name: highavailability
+    slug: highavailability
+  - name: ansible
+    slug: ansible
+  - name: infrastructure-as-code
+    slug: infrastructure-as-code
+comments: []
+---
+<h2 id="gi%E1%BB%9Bi-thi%E1%BB%87u">Giới Thiệu</h2><p>High Availability (HA) là yêu cầu thiết yếu đối với bất kỳ hệ thống database nào trong môi trường production. Tuy nhiên, việc triển khai một PostgreSQL HA cluster từ đầu thường đòi hỏi nhiều thời gian nghiên cứu, dễ xảy ra sai sót trong quá trình cấu hình thủ công, và khó khăn trong việc duy trì tính nhất quán giữa các môi trường.</p><p>Bài viết này chia sẻ kinh nghiệm của chúng tôi trong việc phát triển một giải pháp automation hoàn chỉnh sử dụng Ansible, giúp triển khai PostgreSQL HA cluster một cách nhanh chóng và đáng tin cậy. Sau khi sử dụng thành công trong production, chúng tôi quyết định open-source giải pháp này cho cộng đồng.</p><p><strong>Repository</strong>:&nbsp;<a href="https://github.com/xdev-asia-labs/postgres-patroni-etcd-install">postgres-patroni-etcd-install</a></p><h3 id="c%C3%A1c-t%C3%ADnh-n%C4%83ng-ch%C3%ADnh">Các Tính Năng Chính</h3><p><strong>Automation &amp; Deployment</strong></p><ul><li>Triển khai tự động toàn bộ cluster với một lệnh duy nhất</li><li>Configuration as Code với hơn 70 biến môi trường được quản lý tập trung</li><li>Hỗ trợ multi-environment (development, staging, production)</li></ul><p><strong>High Availability</strong></p><ul><li>Auto-failover với Patroni (thời gian chuyển đổi 30-45 giây)</li><li>Streaming replication với PostgreSQL 18.1</li><li>Tự động khôi phục node bị lỗi với pg_rewind</li></ul><p><strong>Performance &amp; Scalability</strong></p><ul><li>Connection pooling với PgBouncer (tỷ lệ multiplexing 13:1)</li><li>Hỗ trợ load balancing cho read queries</li><li>Tối ưu hóa cho hệ thống với RAM từ 16GB đến 64GB+</li></ul><p><strong>DevOps Integration</strong></p><ul><li>CI/CD pipeline với GitHub Actions</li><li>Automated testing và validation</li><li>Security scanning tích hợp</li></ul><h2 id="b%E1%BB%91i-c%E1%BA%A3nh-v%C3%A0-%C4%91%E1%BB%99ng-l%E1%BB%B1c-ph%C3%A1t-tri%E1%BB%83n">Bối Cảnh và Động Lực Phát Triển</h2><h3 id="v%E1%BA%A5n-%C4%91%E1%BB%81-th%E1%BB%B1c-t%E1%BA%BF">Vấn Đề Thực Tế</h3><p>Trong quá trình vận hành hệ thống production, chúng tôi đã trải qua một sự cố nghiêm trọng khi PostgreSQL server gặp lỗi phần cứng vào lúc 2 giờ sáng. Kết quả là toàn bộ ứng dụng ngừng hoạt động, và phải mất 45 phút để khôi phục từ backup. Sự cố này không chỉ gây thiệt hại về mặt doanh thu mà còn ảnh hưởng đến uy tín và niềm tin của khách hàng.</p><h3 id="th%C3%A1ch-th%E1%BB%A9c-khi-tri%E1%BB%83n-khai-ha">Thách Thức Khi Triển Khai HA</h3><p>Sau sự cố, chúng tôi quyết định triển khai giải pháp High Availability. Tuy nhiên, việc cấu hình thủ công gặp phải nhiều khó khăn:</p><p><strong>Độ phức tạp cao</strong>: Cần hiểu sâu về PostgreSQL replication, Patroni, etcd, và các tương tác giữa chúng. Quá trình nghiên cứu và cấu hình kéo dài 2-3 ngày cho một engineer có kinh nghiệm.</p><p><strong>Rủi ro sai sót</strong>: Cấu hình thủ công dễ dẫn đến inconsistency giữa các nodes, gây ra các vấn đề khó debug. Một sai sót nhỏ trong file config có thể khiến toàn bộ cluster không hoạt động đúng.</p><p><strong>Khó maintain</strong>: Khi cần update configuration hoặc scale cluster, phải thực hiện thủ công trên từng node, tốn thời gian và dễ sai sót.</p><p><strong>Thiếu documentation</strong>: Không có tài liệu chi tiết về quá trình setup, khiến việc onboard engineer mới vào dự án trở nên khó khăn.</p><h3 id="gi%E1%BA%A3i-ph%C3%A1p">Giải Pháp</h3><p>Chúng tôi đã phát triển một bộ Ansible playbooks để giải quyết các vấn đề trên:</p><p><strong>Infrastructure as Code</strong>: Toàn bộ cấu hình được version control, dễ dàng review và rollback khi cần.</p><p><strong>Repeatable Deployment</strong>: Có thể triển khai cluster giống hệt nhau trên nhiều môi trường khác nhau (dev, staging, production) chỉ bằng cách thay đổi file&nbsp;<code>.env</code>.</p><p><strong>Self-documenting</strong>: Code Ansible rõ ràng, kèm theo README chi tiết, giúp team mới dễ dàng hiểu và sử dụng.</p><p><strong>CI/CD Integration</strong>: Tự động validate configuration trước khi deploy, giảm thiểu rủi ro lỗi.</p><p>Sau khi sử dụng thành công trong production trong hơn 6 tháng, chúng tôi quyết định open-source giải pháp này để chia sẻ với cộng đồng.</p><h2 id="ki%E1%BA%BFn-tr%C3%BAc-h%E1%BB%87-th%E1%BB%91ng">Kiến Trúc Hệ Thống</h2><h3 id="tech-stack">Tech Stack</h3><p>Giải pháp sử dụng các công nghệ được kiểm chứng trong cộng đồng:</p>
+<!--kg-card-begin: html-->
+<table class="sc-jTzLTM pLVjq" style="font-family: -apple-system, BlinkMacSystemFont, &quot;Segoe WPC&quot;, &quot;Segoe UI&quot;, Ubuntu, &quot;Droid Sans&quot;, sans-serif; overflow-wrap: break-word; font-size: 14px; line-height: 1.6; border-collapse: collapse; color: rgb(212, 212, 212); font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(30, 30, 30); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><thead><tr><th style="text-align: left; border-bottom: 1px solid rgba(255, 255, 255, 0.69); padding: 5px 10px; border-top-color: rgba(255, 255, 255, 0.69); border-right-color: rgba(255, 255, 255, 0.69); border-left-color: rgba(255, 255, 255, 0.69);">Component</th><th style="text-align: left; border-bottom: 1px solid rgba(255, 255, 255, 0.69); padding: 5px 10px; border-top-color: rgba(255, 255, 255, 0.69); border-right-color: rgba(255, 255, 255, 0.69); border-left-color: rgba(255, 255, 255, 0.69);">Version</th><th style="text-align: left; border-bottom: 1px solid rgba(255, 255, 255, 0.69); padding: 5px 10px; border-top-color: rgba(255, 255, 255, 0.69); border-right-color: rgba(255, 255, 255, 0.69); border-left-color: rgba(255, 255, 255, 0.69);">Vai Trò</th></tr></thead><tbody><tr><td style="padding: 5px 10px;">PostgreSQL</td><td style="padding: 5px 10px;">18.1</td><td style="padding: 5px 10px;">Database engine chính</td></tr><tr><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Patroni</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">4.1.0</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">HA orchestration và automatic failover</td></tr><tr><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">etcd</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">3.5.25</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Distributed configuration store</td></tr><tr><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">PgBouncer</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">1.25.0</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Connection pooling layer</td></tr><tr><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Ansible</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">2.12+</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Infrastructure automation</td></tr></tbody></table>
+<!--kg-card-end: html-->
+<h3 id="ki%E1%BA%BFn-tr%C3%BAc-t%E1%BB%95ng-quan">Kiến Trúc Tổng Quan</h3><pre><code class="language-text">┌─────────────────────────────────────┐
+│       Application Layer             │
+│  (Spring Boot / Django / Node.js)   │
+└──────────────┬──────────────────────┘
+               │ Port 6432 (PgBouncer)
+        ┌──────┴──────┬──────────┐
+        ▼             ▼          ▼
+   ┌────────┐    ┌────────┐   ┌────────┐
+   │PgBouncer│   │PgBouncer│  │PgBouncer│
+   │Node 1   │   │Node 2   │  │Node 3   │
+   └────┬───┘    └────┬───┘   └────┬───┘
+        │ Port 5432   │             │
+   ┌────▼────┐   ┌───▼────┐   ┌────▼────┐
+   │PostgreSQL│  │PostgreSQL│ │PostgreSQL│
+   │ PRIMARY │  │ REPLICA  │ │ REPLICA  │
+   │Read/Write│  │Read Only│ │Read Only │
+   └────┬────┘   └────┬────┘  └────┬────┘
+        │ Port 8008   │             │
+   ┌────▼────┐   ┌────▼────┐  ┌────▼────┐
+   │ Patroni │   │ Patroni │  │ Patroni │
+   │HA Mgr   │   │HA Mgr   │  │ HA Mgr  │
+   └────┬────┘   └────┬────┘  └────┬────┘
+        │ Port 2379   │             │
+        └──────┬──────┴─────────────┘
+               ▼
+        ┌──────────────────┐
+        │   etcd Cluster   │
+        │ (Leader Election)│
+        └──────────────────┘
+</code></pre><h3 id="gi%E1%BA%A3i-th%C3%ADch-c%C3%A1c-th%C3%A0nh-ph%E1%BA%A7n">Giải Thích Các Thành Phần</h3><p><strong>PgBouncer Layer</strong>: Được deploy trên mỗi node để cung cấp connection pooling. Application có thể connect đến bất kỳ node nào, giảm single point of failure và network latency.</p><p><strong>PostgreSQL Cluster</strong>: Sử dụng streaming replication với một primary node (read/write) và hai replica nodes (read-only). Patroni quản lý toàn bộ lifecycle của cluster.</p><p><strong>Patroni</strong>: Đóng vai trò là HA orchestrator, thực hiện health check liên tục, tự động failover khi primary bị lỗi, và đảm bảo data consistency thông qua distributed consensus.</p><p><strong>etcd Cluster</strong>: Lưu trữ cấu hình cluster và thực hiện leader election. Đảm bảo chỉ có một primary node tại mỗi thời điểm, tránh split-brain scenario.</p><h3 id="t%E1%BA%A1i-sao-3-nodes">Tại Sao 3 Nodes?</h3><p>Số lượng 3 nodes là minimum cho một HA cluster do:</p><ul><li><strong>Quorum</strong>: etcd cần ít nhất 3 nodes để đạt được quorum (2/3) và tolerate 1 node failure</li><li><strong>Cost-effective</strong>: Đủ để đảm bảo HA mà không quá tốn kém về infrastructure</li><li><strong>Proven pattern</strong>: Là số lượng standard được recommend bởi cộng đồng PostgreSQL và etcd</li></ul><h2 id="h%C6%B0%E1%BB%9Bng-d%E1%BA%ABn-tri%E1%BB%83n-khai">Hướng Dẫn Triển Khai</h2><h3 id="y%C3%AAu-c%E1%BA%A7u-h%E1%BB%87-th%E1%BB%91ng">Yêu Cầu Hệ Thống</h3><p><strong>Hardware (mỗi node)</strong></p><p>Minimum cho môi trường lab/development:</p><ul><li>CPU: 2 cores</li><li>RAM: 4 GB</li><li>Disk: 20 GB (OS) + 20 GB (Data)</li><li>Network: 1 Gbps</li></ul><p>Recommended cho production:</p><ul><li>CPU: 4-8 cores</li><li>RAM: 16-32 GB</li><li>Disk: 50 GB SSD (OS) + 100+ GB NVMe SSD (Data)</li><li>Network: 10 Gbps</li></ul><p><strong>Software</strong></p><p>Control node (máy chạy Ansible):</p><ul><li>Ansible &gt;= 2.12</li><li>Python &gt;= 3.9</li></ul><p>Target nodes:</p><ul><li>Ubuntu 22.04 LTS / Debian 12 / Rocky Linux 9</li><li>SSH access với root hoặc sudo privileges</li><li>Python 3.x installed</li></ul><h3 id="c%C3%A1c-b%C6%B0%E1%BB%9Bc-tri%E1%BB%83n-khai">Các Bước Triển Khai</h3><p><strong>Bước 1: Chuẩn Bị Repository</strong></p><pre><code class="language-bash">git clone https://github.com/xdev-asia-labs/postgres-patroni-etcd-install.git
+cd postgres-patroni-etcd-install
+</code></pre><p><strong>Bước 2: Cấu Hình Environment</strong></p><p>Tạo file cấu hình từ template:</p><pre><code class="language-bash">cp .env.example .env
+</code></pre><p>Chỉnh sửa các thông số quan trọng:</p><pre><code class="language-bash"># Địa chỉ IP của các nodes
+NODE1_IP=10.0.0.11
+NODE2_IP=10.0.0.12
+NODE3_IP=10.0.0.13
+
+# Mật khẩu PostgreSQL (bắt buộc phải thay đổi)
+POSTGRESQL_SUPERUSER_PASSWORD=your_strong_password_here
+POSTGRESQL_REPLICATION_PASSWORD=your_replication_password_here
+
+# Performance tuning (ví dụ cho server 16GB RAM)
+POSTGRESQL_SHARED_BUFFERS=4GB
+POSTGRESQL_EFFECTIVE_CACHE_SIZE=12GB
+POSTGRESQL_MAX_CONNECTIONS=100
+PGBOUNCER_MAX_CLIENT_CONN=1000
+</code></pre><p><strong>Bước 3: Cấu Hình Inventory</strong></p><p>Chỉnh sửa&nbsp;<code>inventory/hosts.yml</code>:</p><pre><code class="language-yaml">all:
+  children:
+    postgres:
+      hosts:
+        pg-node1:
+          ansible_host: 10.0.0.11
+          patroni_name: node1
+</code></pre><p><strong>Bước 4: Triển Khai Cluster</strong></p><pre><code class="language-bash"># Load environment variables
+set -a &amp;&amp; source .env &amp;&amp; set +a
+
+# Deploy cluster
+ansible-playbook playbooks/site.yml -i inventory/hosts.yml
+</code></pre><p><strong>Bước 5: Xác Minh</strong></p><pre><code class="language-bash">ssh root@10.0.0.11 "patronictl -c /etc/patroni/patroni.yml list"
+</code></pre><h2 id="t%C3%ADnh-n%C4%83ng-n%E1%BB%95i-b%E1%BA%ADt">Tính Năng Nổi Bật</h2><h3 id="configuration-as-code">Configuration as Code</h3><p>Toàn bộ configuration được quản lý trong file&nbsp;<code>.env</code>&nbsp;với hơn 70 variables, giúp:</p><ul><li>Dễ dàng quản lý và audit configuration</li><li>Chuyển đổi giữa các môi trường chỉ bằng cách swap file&nbsp;<code>.env</code></li><li>Bảo mật tốt hơn với&nbsp;<code>.gitignore</code>&nbsp;cho sensitive data</li><li>Developer-friendly, không cần hiểu sâu về Ansible</li></ul><h3 id="connection-pooling">Connection Pooling</h3><p>PgBouncer được cấu hình để tối ưu hóa kết nối:</p><ul><li>Tỷ lệ multiplexing 13:1 (3000 client → 225 backend connections)</li><li>Automatic failover với multi-host support</li><li>Giảm memory và CPU overhead trên PostgreSQL</li></ul><h3 id="zero-downtime-operations">Zero-Downtime Operations</h3><p><strong>Planned Switchover</strong>: Chuyển đổi primary node một cách có kế hoạch với downtime chỉ 2-5 giây.</p><p><strong>Automatic Failover</strong>: Tự động failover trong 30-45 giây khi primary bị lỗi.</p><p><strong>Rolling Updates</strong>: Update cấu hình hoặc version mà không ảnh hưởng đến service availability.</p><h2 id="cicd-pipeline">CI/CD Pipeline</h2><h3 id="automated-validation">Automated Validation</h3><p>GitHub Actions tự động validate mỗi thay đổi:</p><ul><li>YAML syntax checking</li><li>Ansible playbooks validation</li><li>Security scanning (Trivy, TruffleHog)</li><li>Code quality checks</li></ul><h3 id="release-automation">Release Automation</h3><p>Khi tạo tag mới (v1.0.0), GitHub Actions tự động:</p><ul><li>Generate changelog từ git history</li><li>Tạo release archive</li><li>Publish GitHub Release với documentation</li></ul><h2 id="performance">Performance</h2><p>Trong môi trường test với 3 nodes (16GB RAM, 5 cores mỗi node):</p><ul><li>Read QPS: 50,000-100,000</li><li>Write QPS: 10,000-20,000</li><li>Failover time: 30-45 seconds</li><li>Connection capacity: 3,000 clients</li><li>Query latency: &lt;5ms (simple queries)</li></ul><h2 id="b%C3%A0i-h%E1%BB%8Dc-kinh-nghi%E1%BB%87m">Bài Học Kinh Nghiệm</h2><h3 id="1-s%E1%BB%AD-d%E1%BB%A5ng-proven-tools">1. Sử Dụng Proven Tools</h3><p>Thay vì tự phát triển, chúng tôi sử dụng các công nghệ đã được kiểm chứng như Patroni, etcd, và PgBouncer. Điều này giúp tập trung vào automation thay vì reinvent the wheel.</p><h3 id="2-configuration-as-code">2. Configuration as Code</h3><p>Externalize configuration ra&nbsp;<code>.env</code>&nbsp;file thay vì hardcode trong playbooks giúp dễ dàng customize và maintain cho different environments.</p><h3 id="3-security-first">3. Security First</h3><p>Luôn prioritize security từ đầu:</p><ul><li>Sử dụng&nbsp;<code>.gitignore</code>&nbsp;cho sensitive files</li><li>Generate strong passwords</li><li>Tự động configure firewall rules</li><li>Tích hợp security scanning trong CI</li></ul><h3 id="4-documentation-matters">4. Documentation Matters</h3><p>Documentation tốt giảm onboarding time và thể hiện sự professional của dự án. Chúng tôi maintain documentation đầy đủ bằng cả English và Vietnamese.</p><h2 id="roadmap">Roadmap</h2><p>Các tính năng đang phát triển:</p><ul><li>Tích hợp Prometheus/Grafana monitoring</li><li>Automated backup với pgBackRest</li><li>Terraform support cho cloud deployment</li><li>Docker/Kubernetes deployment option</li><li>Multi-region replication</li></ul><h2 id="khi-n%C3%A0o-n%C3%AAn-s%E1%BB%AD-d%E1%BB%A5ng">Khi Nào Nên Sử Dụng</h2><p><strong>Phù hợp với:</strong></p><ul><li>Applications yêu cầu high availability (uptime &gt; 99.9%)</li><li>Hệ thống không thể tolerate extended downtime</li><li>Multi-tenant applications với nhiều concurrent connections</li><li>Teams áp dụng Infrastructure as Code</li></ul><p><strong>Không cần thiết khi:</strong></p><ul><li>Development/testing environments đơn giản</li><li>Low-traffic applications</li><li>Applications có thể accept occasional downtime</li><li>Budget constraints (cần ít nhất 3 servers)</li></ul><h2 id="k%E1%BA%BFt-lu%E1%BA%ADn">Kết Luận</h2><p>Việc xây dựng một PostgreSQL High Availability cluster không còn là thách thức lớn nếu có đúng tools và phương pháp tiếp cận. Giải pháp này đã được kiểm chứng trong production và giúp đảm bảo uptime cho nhiều hệ thống quan trọng.</p><p>Với bộ Ansible playbooks này, bạn có thể triển khai production-ready cluster trong 10 phút, đạt được uptime trên 99.9%, và quản lý infrastructure theo phương pháp Infrastructure as Code.</p><h3 id="%C4%91%C3%B3ng-g%C3%B3p">Đóng Góp</h3><p>Nếu bạn thấy dự án hữu ích:</p><ul><li>⭐ Star repository</li><li>🐛 Report issues</li><li>💬 Share feedback</li><li>🤝 Contribute code</li><li>📢 Share với cộng đồng</li></ul>