Trang chủ Bài viết Cơ sở dữ liệu Chạy PostgreSQL trong Docker cho môi trường production: volume, bộ nhớ chia sẻ, pooling và sao lưu
Cơ sở dữ liệu 18/11/2026 3 lượt xem

Chạy PostgreSQL trong Docker cho môi trường production: volume, bộ nhớ chia sẻ, pooling và sao lưu

Chạy PostgreSQL trong Docker cho môi trường production: volume, bộ nhớ chia sẻ, pooling và sao lưu

Chạy PostgreSQL trong Docker chỉ mất vài giây ở môi trường phát triển, nhưng có thể khiến dữ liệu production gặp rủi ro nếu dùng nguyên một file compose.yaml mẫu từ hướng dẫn trên mạng. Theo tác giả Aleksei Aleinikov, phần lớn sự cố với Postgres chạy container không phải do Docker, mà do các giá trị mặc định của Docker xung đột với cách PostgreSQL quản lý bộ nhớ, checkpoint và tệp trên đĩa.

Thay đổi quan trọng ở PostgreSQL 18+

Từ PostgreSQL 18, PGDATA được chuyển vào các thư mục con theo phiên bản dưới /var/lib/postgresql (ví dụ /var/lib/postgresql/18/docker), thay vì /var/lib/postgresql/data như trước. Thay đổi này giúp pg_upgrade --link nâng cấp phiên bản lớn thuận tiện hơn trong cùng thư mục cha.

Không trỏ postgres:18 vào volume cũ của PostgreSQL 17 vì các phiên bản lớn không tương thích nhị phân trên đĩa và container sẽ không khởi động. Quy trình an toàn gồm bốn bước: dùng pg_dumpall từ container PG 17 đang chạy để xuất toàn bộ dữ liệu; chạy docker compose down nhưng không dùng tùy chọn -v để giữ volume cũ; cập nhật compose.yaml sang image postgres:18.1-bookworm với volume mới gắn tại /var/lib/postgresql; rồi khôi phục bản dump vào container PG 18 mới.

Năm bẫy âm thầm trong cấu hình mặc định

  • Giới hạn 64 MB của /dev/shm: Docker mặc định giới hạn /dev/shm ở 64 MB, trong khi PostgreSQL dùng bộ nhớ chia sẻ POSIX cho các segment DSM và truy vấn song song. Dưới tải thực tế, truy vấn có thể lỗi "could not resize shared memory segment". Cần đặt shm_size từ 1gb trở lên, có thể 2–4gb trên máy lớn.
  • Thời gian chờ 10 giây trước SIGKILL: Khi chạy docker stop, Docker chỉ chờ 10 giây trước khi gửi SIGKILL. Nếu PostgreSQL còn nhiều buffer bẩn cần ghi khi checkpoint, tiến trình bị giết giữa chừng và lần khởi động sau phải phục hồi WAL chậm. Nên đặt stop_grace_period: 60s, hoặc 120s với hệ thống ghi nhiều.
  • Healthcheck sai: Lệnh pg_isready không kèm tham số kiểm tra user và database mặc định, có thể báo khỏe trong lúc initdb đang khởi động lại. Cần chỉ rõ user và database đích trong healthcheck.
  • Cạn kiệt kết nối khi không có pooler: PostgreSQL tạo một tiến trình backend riêng cho mỗi kết nối, tốn khoảng 5–10 MB RAM cùng work_mem. Một đợt bùng nổ hàng trăm hàm serverless có thể gây OOM kill. Giải pháp là đặt PgBouncer phía trước ở chế độ transaction pooling, giữ max_connections của Postgres ở mức hợp lý (khoảng 100–150) trong khi PgBouncer tiếp nhận hơn 500 kết nối. Từ PgBouncer 1.21, prepared statement cấp giao thức hoạt động native ở chế độ transaction qua MAX_PREPARED_STATEMENTS.
  • Volume named so với bind mount và quyền truy cập: Trên Linux production nên dùng named volume Docker trên SSD NVMe cục bộ, hoặc đường dẫn host do UID/GID 999:999 sở hữu. Không đặt PGDATA trên share mạng SMB/CIFS.

Cấu hình compose.yaml mẫu

Bản mẫu dành cho máy 8 GB RAM gồm hai service. Service postgres pin đúng phiên bản image, đặt stop_grace_period 60s, shm_size 1gb, bật --data-checksums khi initdb, cấu hình các tham số shared_buffers, effective_cache_size, work_mem, maintenance_work_mem, max_connections, wal_level, random_page_cost và effective_io_concurrency, kèm healthcheck đúng và giới hạn log.

Service pgbouncer dùng image edoburu/pgbouncer, chế độ transaction, MAX_CLIENT_CONN 500, DEFAULT_POOL_SIZE 30, MAX_PREPARED_STATEMENTS 200, xác thực scram-sha-256. Cổng 5432 không được publish ra ngoài, PgBouncer chỉ bind vào 127.0.0.1:6432 hoặc mạng nội bộ.

Kích thước bộ nhớ theo dung lượng RAM

Các thông số cần co giãn theo RAM của máy chủ, vì PostgreSQL dựa nhiều vào page cache của hệ điều hành nên cố ý để khoảng 50–75% RAM ngoài shared_buffers:

  • 2 GB RAM: shm_size 512mb, shared_buffers 512MB, effective_cache_size 1536MB, work_mem 4MB, max_connections 60
  • 4 GB RAM: 1gb, 1GB, 3GB, 8MB, 80
  • 8 GB RAM: 1gb, 2GB, 6GB, 16MB, 120
  • 16 GB RAM: 2gb, 4GB, 12GB, 32MB, 150
  • 32 GB RAM: 4gb, 8GB, 24GB, 64MB, 200

Sao lưu và phục hồi thảm họa

Không bao giờ tar một volume đang chạy, vì sao chép tệp PGDATA thô bằng tar hay rsync khi PostgreSQL đang hoạt động sẽ tạo bản sao lưu không thể phục hồi. Có hai cách đúng: với cơ sở dữ liệu dưới khoảng 30–50 GB, chạy pg_dump -Fc theo lịch và gửi archive mã hóa lên lưu trữ tương thích S3 như Cloudflare R2; với cơ sở dữ liệu lớn hoặc yêu cầu RPO thấp, dùng pgBackRest hoặc WAL-G để lưu trữ WAL liên tục và phục hồi theo thời điểm (PITR).

Mỗi tháng nên kiểm chứng khả năng phục hồi bằng một container tạm: khởi động container thử, chạy pg_restore từ bản dump mới nhất, kiểm tra số dòng rồi xóa container. Một bản sao lưu chưa từng thử phục hồi chỉ là hy vọng.

Ba lỗi thường gặp

  • Container thoát ngay sau khi nâng cấp lên postgres:18: đã gắn volume của PG 17 trở xuống vào image PG 18+. Cần quay lại tag postgres:17, dump bằng pg_dumpall rồi khôi phục vào volume mới tại /var/lib/postgresql.
  • Lỗi "could not resize shared memory segment": /dev/shm đã chạm mức 64 MB của Docker. Tăng shm_size lên 1gb trở lên và tạo lại container.
  • Lỗi "chown: changing permissions ... Operation not permitted": thường gặp khi dùng bind mount trên macOS/Windows hoặc ánh xạ UID rootless nghiêm ngặt. Chuyển sang named volume hoặc chown -R 999:999 trên đường dẫn host Linux.

Nguồn: Planet PostgreSQL

Trích nguồn từ: Planet PostgreSQL

Chia sẻ:

Bài viết liên quan

Zalo