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
Tags:
Bài viết liên quan
Khóa chính phân tán trong PostgreSQL: chọn ID nào khi nhiều vùng cùng ghi?
Dimitri Fontaine phân tích chi phí của năm kiểu khóa chính cho bảng được ghi đồng thời từ nhiều vùng trong PostgreSQL, từ sequence theo vùng đến uuidv7 và khóa ghép (region, id).
Đọc thêm
Chris van Eijk: Lỗi 'invalid input syntax for type json' trong PostgreSQL và cách đo lường
Bài viết của Chris van Eijk phân tích nguyên nhân gây lỗi 'invalid input syntax for type json' (mã 22P02) trên PostgreSQL 16 đến 18, từ mảng JS, list Python, escape NUL đến các hàng dữ liệu lỗi và cách ALTER an toàn.
Đọc thêm
Postgres 18.7: Gói Debian và Red Hat bảo vệ người dùng khỏi cài đặt sai phiên bản
Jeremy Schneider ghi nhận các gói Postgres trên Debian và Red Hat đã thêm ràng buộc phiên bản, giúp ngăn việc cài extension mới lên bản Postgres cũ và tránh tình trạng hỏng gói.
Đọc thêm
Postgres 18.7 phá vỡ tương thích ABI lần nữa
Bản cập nhật nhỏ Postgres 18.7 buộc phải thay đổi ABI để vá CVE-2026-6460, khiến các extension C phải biên dịch lại và nâng cấp đồng bộ với database.
Đọc thêmPostgreSQL ra mắt loạt bản vá tháng 11/2026: cập nhật máy chủ và tiện ích mở rộng cùng lúc
PostgreSQL 18.7, 17.12, 16.16, 15.20 và 14.25 được phát hành với bản vá CVE-2026-6460, buộc phải cập nhật máy chủ và toàn bộ tiện ích mở rộng trong cùng một giao dịch trên các kho RPM của PGDG.
Đọc thêm
Tìm kiếm vector PostgreSQL với pgvector và hybrid search trong Next.js
Hướng dẫn xây dựng tìm kiếm kết hợp từ khóa và vector trong PostgreSQL bằng pgvector, kết nối với Next.js Route Handler, áp dụng RLS theo tenant và đo độ chính xác của chỉ mục HNSW khi có bộ lọc.
Đọc thêm
B-tree trong PostgreSQL: trang chỉ mục có thứ tự và thưa dần sau VACUUM
Bài viết của Radim Marek mổ xẻ cấu trúc trang B-tree trong PostgreSQL: khác với heap page, trang chỉ mục được sắp xếp, liên kết với trang anh em và VACUUM không thể thu hồi không gian bên trong trang lá.
Đọc thêmCùng truy vấn, cùng index nhưng hiệu năng khác nhau khi chuyển PostgreSQL lên Azure
Câu chuyện khách hàng chuyển PostgreSQL lên Azure gặp truy vấn chậm gấp hàng chục lần dù vẫn dùng index scan, nguyên nhân nằm ở cách dữ liệu được sắp xếp trên đĩa chứ không phải index hay storage.
Đọc thêm
json và jsonb trong PostgreSQL: đo kích thước và tốc độ thực tế
So sánh json và jsonb trên PostgreSQL 17 và 18 với sáu dạng tài liệu, cho thấy jsonb có thể nhỏ hơn 23% hoặc lớn hơn 41%, kèm tốc độ đọc và chỉ mục GIN.
Đọc thêmPostgreSQL có thực sự đang thắng? Bằng chứng vượt xa các bảng xếp hạng
Bài viết của Dave Stokes tổng hợp khảo sát người dùng, các thương vụ mua bán công ty PostgreSQL, sản phẩm của đối thủ và lựa chọn của AI agent để lập luận PostgreSQL đang dẫn đầu mảng cơ sở dữ liệu vận hành.
Đọc thêm