Đến nội dung chính
Tutorial

Docker Compose healthcheck: đợi PostgreSQL sẵn sàng trước khi chạy app

Dùng healthcheck kết hợp servicehealthy để ứng dụng chờ PostgreSQL, rồi kiểm tra bằng một truy vấn SQL chạy trong Docker Compose.

Docker Compose healthcheck: đợi PostgreSQL sẵn sàng trước khi chạy app

Container đã chạy nhưng cơ sở dữ liệu còn khởi tạo là nguyên nhân thường gặp của lỗi kết nối lúc deploy. Trong Docker Compose, thêm healthcheck cho PostgreSQL và dùng depends_on.condition: service_healthy trong dịch vụ phụ thuộc để chờ lượt kiểm tra thành công. Tài liệu thứ tự khởi động của Docker

1. Tạo compose.yaml trong thư mục thử nghiệm

Mẫu chỉ dùng trong Docker cục bộ và không mở cổng PostgreSQL ra ngoài máy chủ. Dịch vụ probe chạy một truy vấn rồi thoát, giúp bạn tự kiểm tra việc kết nối giữa hai container.

services:
  db:
    image: postgres:18
    environment:
      POSTGRES_USER: demo
      POSTGRES_PASSWORD: demo-local-only
      POSTGRES_DB: workshop
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "demo", "-d", "workshop", "-h", "127.0.0.1"]
      interval: 2s
      timeout: 2s
      retries: 15
      start_period: 10s
  probe:
    image: postgres:18
    environment:
      PGPASSWORD: demo-local-only
    depends_on:
      db:
        condition: service_healthy
    command: ["psql", "-h", "db", "-U", "demo", "-d", "workshop", "-Atc", "SELECT 1"]

2. Chạy và đọc kết quả

docker compose config --quiet
docker compose up -d
docker compose ps -a
docker compose logs probe

Khi thành công, db báo healthy, probe thoát với mã 0 và log của probe in 1. Nếu db chưa sẵn sàng, xem docker compose logs db. Nếu db đã khỏe mà truy vấn lỗi, kiểm tra lại tên cơ sở dữ liệu, tài khoản và mật khẩu.

3. Đưa vào ứng dụng

Giữ healthcheck trên db và thay probe bằng dịch vụ backend. pg_isready xác nhận máy chủ có thể nhận kết nối. Ứng dụng vẫn cần xác thực thành công, chạy migration phù hợp và xử lý mất kết nối trong khi vận hành. Với production, lưu mật khẩu bằng cơ chế quản lý bí mật của môi trường triển khai. Tài liệu pg_isready

Ảnh bìa minh họa do AI tạo cho iCoderX.

Cài đặt Cookie

Bạn có thể thay đổi lựa chọn bất cứ lúc nào.