KnowledgeHub
VI EN

Bài viết

Docker Compose: services, depends_on và healthcheck

Compose không chỉ là gom nhiều container vào một file — depends_on và healthcheck mới là thứ làm stack chạy ổn định.

28/08/2026 · 0 phút đọc · 9 lượt xem

services — mỗi container là một service

yaml
services:
  app:
    build: .
    ports: ["127.0.0.1:3000:3000"]
  db:
    image: postgres:16-alpine

depends_on — thứ tự khởi động

depends_on bảo Compose start db trước app. Nhưng start trước không có nghĩa là sẵn sàng — Postgres cần vài giây mới nhận kết nối.

yaml
app:
  depends_on:
    db:
      condition: service_healthy

healthcheck — sẵn sàng mới cho chạy tiếp

yaml
db:
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U knowledge_hub"]
    interval: 5s
    retries: 10

Kết hợp depends_on với condition: service_healthy, app chỉ start khi DB thật sự nhận kết nối — hết lỗi "connection refused" lúc boot.

Quy tắc nhớ

depends_on không có healthcheck chỉ là gợi ý thứ tự. Muốn stack boot ổn định thì healthcheck là bắt buộc, không phải tùy chọn.