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.