DPTCloud
Quay lại danh sách
Tin tức công nghệ

Hướng Dẫn Thực Tế: Xây Dựng Cụm PostgreSQL High Availability Với Patroni, Etcd và PgBouncer Trên 3 VPS Chi Phí Thấp

3 tháng 6, 2026

Giới thiệu về bài toán High Availability cho PostgreSQL

Trong kỷ nguyên số, dữ liệu được ví như dòng máu của doanh nghiệp. Một phút gián đoạn dịch vụ (downtime) của hệ thống cơ sở dữ liệu không chỉ gây thiệt hại về doanh thu mà còn làm suy giảm nghiêm trọng uy tín thương hiệu. Đối với các doanh nghiệp vừa và nhỏ (SMEs) hoặc các dự án khởi nghiệp, việc triển khai một hệ thống PostgreSQL High Availability (HA - Chịu lỗi cao) thường gặp rào cản lớn về chi phí hạ tầng.

Tuy nhiên, với sự kết hợp mạnh mẽ của bộ ba công cụ mã nguồn mở: Patroni, Etcd, và PgBouncer, chúng ta hoàn toàn có thể xây dựng một cụm (cluster) cơ sở dữ liệu có khả năng tự động sửa lỗi, phân phối tải hiệu quả ngay trên 3 VPS cấu hình thấp. Bài viết này sẽ hướng dẫn bạn chi tiết từ tư duy kiến trúc đến các bước cấu hình thực tế.

Kiến trúc tổng quan của hệ thống

Để đạt được trạng thái High Availability thực sự mà không bị rơi vào tình trạng Split-Brain (hiện tượng hai node cùng tự nhận là Master), mô hình tối thiểu yêu cầu 3 node (VPS) để đạt được đồng thuận số đông (Quorum). Kiến trúc của chúng ta sẽ bao gồm các thành phần cốt lõi sau:

  • PostgreSQL (v15/v16): Hệ quản trị cơ sở dữ liệu chính.
  • Patroni: Công cụ điều phối (Orchestrator) được viết bằng Python, chịu trách nhiệm quản lý trạng thái, cấu hình Replication và tự động kích hoạt Failover khi Master gặp sự cố.
  • Etcd: Hệ thống lưu trữ key-value phân tán, đóng vai trò làm Distributed Configuration Store (DCS) để Patroni ghi nhận trạng thái của cluster và duy trì Leader Lock.
  • PgBouncer: Trình quản lý kết nối (Connection Pooler) nhẹ, giúp giảm tải cho PostgreSQL bằng cách tái sử dụng các kết nối và định tuyến chính xác traffic Read/Write.

Chuẩn bị hạ tầng và môi trường mạng

Giả sử chúng ta có 3 VPS cài đặt hệ điều hành Ubuntu Server 22.04 LTS thuộc cùng một mạng nội bộ (LAN/VPC) với thông tin IP như sau:

  • Node 1 (Leader/Replica): IP 10.0.0.11 - Hostname: pg-node1
  • Node 2 (Replica/Leader): IP 10.0.0.12 - Hostname: pg-node2
  • Node 3 (Replica/DCS): IP 10.0.0.13 - Hostname: pg-node3
Lưu ý quan trọng: Hãy đảm bảo các cổng dịch vụ như 2379/2380 (Etcd), 8008 (Patroni REST API), 5432 (PostgreSQL), và 6432 (PgBouncer) đã được mở trong tường lửa nội bộ giữa 3 VPS này.

Bước 1: Cài đặt và cấu hình Cluster Etcd

Etcd cần được cài đặt trên cả 3 node để tạo thành một cụm DCS đồng thuận. Chạy lệnh cài đặt trên tất cả các node:

sudo apt-get update && sudo apt-get install -y etcd-server etcd-client

Cấu hình tệp tin /etc/etcd/etcd.yml trên từng node. Dưới đây là ví dụ cấu hình mẫu cho Node 1 (thay đổi IP tương ứng cho Node 2 và Node 3):

name: 'pg-node1'
data-dir: '/var/lib/etcd/pg-cluster.etcd'
listen-peer-urls: '[http://10.0.0.11:2380](http://10.0.0.11:2380)'
listen-client-urls: '[http://10.0.0.11:2379](http://10.0.0.11:2379),[http://127.0.0.127:2379](http://127.0.0.127:2379)'
initial-advertise-peer-urls: '[http://10.0.0.11:2380](http://10.0.0.11:2380)'
initial-cluster: 'pg-node1=[http://10.0.0.11:2380](http://10.0.0.11:2380),pg-node2=[http://10.0.0.12:2380](http://10.0.0.12:2380),pg-node3=[http://10.0.0.13:2380](http://10.0.0.13:2380)'
initial-cluster-token: 'etcd-pg-cluster-token'
initial-cluster-state: 'new'
advertise-client-urls: '[http://10.0.0.11:2379](http://10.0.0.11:2379)'

Khởi động lại dịch vụ Etcd và kiểm tra trạng thái bằng lệnh:

sudo systemctl restart etcd
etcdctl endpoint health --cluster

Nếu tất cả các node đều báo trạng thái healthy, cụm DCS của bạn đã hoạt động sẵn sàng.

Bước 2: Cài đặt PostgreSQL và Patroni

Chúng ta cần cài đặt PostgreSQL nhưng không khởi tạo database mặc định vì Patroni sẽ tự động làm việc này. Thực hiện trên cả 3 node:

sudo apt-get install -y postgresql-15 postgresql-contrib-15 patroni
sudo systemctl stop postgresql
sudo systemctl disable postgresql

Tiếp theo, tạo tệp cấu hình Patroni tại /etc/patroni/patroni.yml. Cấu hình này định nghĩa cách Patroni giao tiếp với Etcd và cách khởi tạo PostgreSQL:

scope: postgres-ha-cluster
namespace: /service
name: pg-node1 # Thay đổi theo từng node

dcs:
  etcd3:
    hosts:
      - 10.0.0.11:2379
      - 10.0.0.12:2379
      - 10.0.0.13:2379
  postgresql:
    use_pg_rewind: true
    use_slots: true

postgresql:
  listen: 10.0.0.11:5432 # IP của từng node
  connect_address: 10.0.0.11:5432
  data_dir: /var/lib/postgresql/15/main
  bin_dir: /usr/lib/postgresql/15/bin
  pg_hba:
    - host replication replicator 10.0.0.0/24 md5
    - host all all 10.0.0.0/24 md5
  authentication:
    replication:
      username: replicator
      password: 'YourSecurePassword'
    superuser:
      username: postgres
      password: 'YourMasterPassword'

restapi:
  listen: 10.0.0.11:8008
  connect_address: 10.0.0.11:8008

Phân quyền cho file cấu hình và khởi động Patroni:

sudo chown postgres:postgres /etc/patroni/patroni.yml
sudo systemctl start patroni
sudo systemctl enable patroni

Kiểm tra trạng thái cluster bằng công cụ patronictl:

patronictl -c /etc/patroni/patroni.yml list

Bạn sẽ thấy một node được bầu làm Leader với trạng thái running, và hai node còn lại đóng vai trò Sync Standby hoặc Replica, tự động đồng bộ dữ liệu thông qua cơ chế Streaming Replication.

Bước 3: Tối ưu hóa kết nối với PgBouncer

Nếu ứng dụng kết nối trực tiếp đến IP của một node PostgreSQL, khi node đó chết, ứng dụng sẽ bị lỗi kết nối cho đến khi cấu hình thủ công lại IP mới. PgBouncer kết hợp với một kịch bản check health hoặc kết hợp HAProxy sẽ giải quyết triệt để vấn đề này.

Cài đặt PgBouncer trên các node hoặc trên một máy chủ ứng dụng độc lập:

sudo apt-get install -y pgbouncer

Cấu hình tệp /etc/pgbouncer/pgbouncer.ini để định tuyến thông minh. Điểm đặc biệt ở đây là bạn có thể cấu hình PgBouncer luôn hướng tới IP của node đang giữ vai trò Leader nhờ vào REST API của Patroni, hoặc sử dụng giải pháp phân tải đọc/ghi riêng biệt.

Sử dụng chế độ Transaction Pooling (pool_mode = transaction) để tối ưu hóa tài nguyên phần cứng tốt nhất cho các VPS giá rẻ có dung lượng RAM hạn chế (từ 2GB đến 4GB).

Kịch bản thử nghiệm khả năng tự phục hồi (Failover)

Để chứng minh hệ thống hoạt động thực sự hiệu quả, chúng ta có thể giả lập tình huống mất điện hoặc sự cố mạng trên Node 1 (đang là Leader):

  1. Chạy lệnh dừng dịch vụ Patroni hoặc tắt hẳn VPS Node 1: sudo systemctl stop patroni
  2. Ngay lập tức, Etcd sẽ phát hiện TTL (Time-To-Live) của Leader Lock hết hạn.
  3. Patroni trên Node 2 và Node 3 sẽ tiến hành bầu chọn. Node có dữ liệu mới nhất (thường là Sync Standby) sẽ được thăng cấp (promoted) lên làm Leader mới trong vòng dưới 10 giây.
  4. Khi Node 1 online trở lại, Patroni sẽ tự động hạ cấp nó xuống làm Replica, sử dụng pg_rewind để đồng bộ ngược lại dữ liệu từ Leader mới mà không cần can thiệp thủ công.

Kết luận và Khuyến nghị vận hành

Việc xây dựng một hệ thống PostgreSQL High Availability bằng Patroni, Etcd và PgBouncer trên 3 VPS giá rẻ là một giải pháp cực kỳ hiệu quả về mặt chi phí nhưng vẫn đảm bảo tính an toàn ở mức độ doanh nghiệp (Enterprise-grade). Hệ thống này loại bỏ hoàn toàn điểm lỗi đơn nhất (Single Point of Failure), giúp ứng dụng của bạn luôn trực tuyến vững vàng trước các sự cố hạ tầng.

Để vận hành hệ thống này một cách tối ưu nhất, hãy lưu ý thực hiện định kỳ việc kiểm tra log của Etcd, sao lưu dữ liệu vật lý (như sử dụng pgBackRest) và thiết lập hệ thống cảnh báo (Prometheus & Grafana) để luôn chủ động trước mọi tình huống.

Hướng Dẫn Thực Tế: Xây Dựng Cụm PostgreSQL High Availability Với Patroni, Etcd và PgBouncer Trên 3 VPS Chi Phí Thấp | DPTCloud