← Tất cả bài viết

PostgreSQL 19 trên VM đơn lẻ: Đừng vội nâng cấp trước khi diễn tập restore

PostgreSQL 19 vừa ra mắt với REPACK CONCURRENTLY. Vì sao người tự host database trên một máy ảo không nên vội nâng cấp, và các bước cần diễn tập an toàn trước với 2server.

PostgreSQL 19 chính thức ra mắt ngày 19/11/2026. Tính năng gây chú ý nhất là lệnh REPACK (CONCURRENTLY) thay thế cho VACUUM FULL và CLUSTER, cho phép dọn sạch dung lượng phình to (bloat) mà không khóa chặt bảng đang chạy. Bản 19 cũng bổ sung tính năng WAIT FOR LSN giúp standby đọc đúng dữ liệu vừa ghi trên primary, cùng extension pg_plan_advice giúp ghìm ổn định kế hoạch thực thi câu lệnh.

Nhưng với những ai đang tự host database trên một máy ảo duy nhất (mô hình 2server đang dựng và vận hành), lên một bản PostgreSQL lớn (major release) không bao giờ là chuyện đổi một dòng tag image rồi restart container.

Bản PostgreSQL lớn thay đổi cấu trúc lưu trữ dữ liệu trên đĩa. Bản 19 không đọc trực tiếp thư mục PGDATA của bản 18 được. Bạn bắt buộc phải chạy pg_upgrade, dump toàn bộ bằng pg_dumpall rồi restore lại, hoặc dùng logical replication.

Trước khi nghĩ tới việc nâng cấp, hãy nhìn thẳng vào bốn thực tế vận hành trên một máy chủ nhỏ.

Một: Template của 2server hiện chạy PostgreSQL 18

Template hiện tại của 2server quản lý PostgreSQL 18 kèm pgBackRest 2.59.2, đúng theo tài liệu PostgreSQL công bố. 2server chưa có lệnh tự động nâng cấp tại chỗ từ 18 lên 19.

Với các ứng dụng stateless (web, API), 2server hỗ trợ deploy blue/green và rollback traffic mượt mà. Nhưng tài liệu chỉ rõ hai ranh giới sống còn:

  • Rollback traffic không đảo ngược được migration database.
  • Các extension lưu trữ trạng thái như postgres cập nhật trực tiếp tại chỗ (in-place) trên volume dữ liệu.

Nếu bạn tự ý sửa manifest để trỏ thẳng vào image PostgreSQL 19 trên volume cũ của bản 18, container sẽ sập hoặc hỏng dữ liệu ngay khi khởi động.

Hai: Những thay đổi dễ gây lỗi trên hệ thống nhỏ

Tài liệu phát hành PostgreSQL 19 có một số điểm gãy cần kiểm tra kỹ trước:

  • Chuỗi escape (standard_conforming_strings): Tham số này bị khóa cứng ở trạng thái bật (on). Các file dump từ database cũ còn dùng dấu gạch chéo ngược (\) theo chuẩn cũ sẽ báo lỗi khi nạp vào bản 19.
  • Cảnh báo đăng nhập bằng MD5: Bản 19 đưa ra cảnh báo mỗi khi đăng nhập thành công bằng MD5 (chuẩn này đã bị đánh dấu lỗi thời từ bản 18 và chuẩn bị bị gỡ bỏ). 2server dùng xác thực SCRAM theo mặc định nên các cụm dựng mới an toàn, nhưng những tài khoản cũ tạo tay cần kiểm tra lại.
  • Tắt JIT mặc định: Bản 19 tắt Just-In-Time compilation theo mặc định vì cơ chế ước tính chi phí trước đây không chuẩn xác cho các câu lệnh transactional nhỏ. Với các VM ít RAM, đây là điểm cộng lớn giúp tiết kiệm CPU và bộ nhớ.
  • Tăng giới hạn khóa: Giá trị mặc định của max_locks_per_transaction tăng từ 64 lên 128 do thay đổi trong bảng khóa nội bộ. Cần theo dõi dung lượng bộ nhớ dùng chung (shared memory) sau khi nâng cấp.
  • Rào cản từ index cũ: pg_upgrade sẽ từ chối nâng cấp thẳng nếu phát hiện index btree_gist trên các kiểu dữ liệu inet hoặc cidr.

Ba: Luôn diễn tập restore trước khi đụng vào production

Đừng bao giờ nâng cấp trực tiếp trên cụm database đang chạy thật. Hãy làm thử trên một bản sao phục hồi từ chính dữ liệu production.

2server có sẵn cơ chế backup liên tục qua WAL archiving và diễn tập restore tự động hằng tuần bằng pgBackRest. Khi cần môi trường riêng biệt để chạy thử pg_upgrade --check hoặc đo thời gian dump/restore, bạn có thể tạo một container phục hồi ngay trên máy ảo:

bash
2srv app postgres restore -f server.local.json --recovery investigate \
  --target-time 2026-11-20T00:00:00Z --apply

Lệnh này khôi phục bản backup vào một container và volume độc lập. Container này không mở cổng TCP và không nối vào mạng nội bộ của ứng dụng, giúp bạn kiểm tra toàn bộ script nâng cấp mà không sợ ảnh hưởng đến traffic thật.

Lưu ý: Quá trình restore cần dung lượng đĩa trống ít nhất gấp 1.2 lần thư mục PGDATA hiện tại, hãy chắc chắn máy ảo còn đủ dung lượng trước khi chạy.

Bốn: Giới hạn của một VM và cửa sổ bảo trì

Một máy ảo là một điểm chịu lỗi duy nhất (single failure domain), không có độ sẵn sàng cao (HA) ở tầng hạ tầng. Nâng cấp database phiên bản lớn bắt buộc phải có thời gian ngừng dịch vụ (downtime):

  1. Tạm dừng nhận dữ liệu mới từ app để tránh lệch dữ liệu.
  2. Chạy backup đầy đủ: 2srv app postgres backup -f server.local.json --apply.
  3. Kiểm tra tính toàn vẹn của backup: 2srv app postgres check-backup -f server.local.json --apply.
  4. Thực hiện nâng cấp dữ liệu qua pg_upgrade hoặc restore file dump vào cụm mới.
  5. Kiểm tra tính toàn vẹn của dữ liệu và ứng dụng trước khi mở lại traffic.

Nếu ứng dụng không thể chấp nhận cửa sổ bảo trì 15 đến 30 phút, bạn cần kiến trúc replication nhiều node, vượt ngoài phạm vi của một máy ảo đơn lẻ.

Việc tiếp theo

Đừng vội nâng cấp PostgreSQL 19 trên hệ thống thật. Hãy gõ 2srv app postgres check-backup -f server.local.json --apply để đảm bảo hệ thống backup của bạn vẫn chạy chuẩn, đọc kỹ release notes PostgreSQL 19, và diễn tập thử quy trình nâng cấp trên một bản restore độc lập.