nguynbon03/deploy-docker

Deploy Docker — Từ local đến production

Chạy local → push GitHub → VPS pull & deploy. Hoàn hảo.

Kiến trúc học từ backend-refresh

project/
  devops/
    docker/
      Dockerfile              → Multi-stage build (nhẹ, bảo mật)
      docker-compose.yml      → Base compose (dùng chung)
      docker-compose.dev.yml  → Dev: local, debug, hot reload
      docker-compose.prod.yml → Prod: healthcheck, restart, optimize
    infra/
      init-scripts/           → Script khởi tạo DB, seed data
  .env.example                → Mẫu env (KHÔNG chứa secret thật)
  .env.development            → Env cho dev (KHÔNG commit)
  .env.production             → Env cho prod (KHÔNG commit)
  .dockerignore               → Loại bỏ file không cần

Quy trình Deploy

1. Dev (Mac local)
   → Viết code + test
   → docker-compose -f devops/docker/docker-compose.dev.yml up
   → Kiểm tra tại localhost:8000

2. Push GitHub
   → git push origin main

3. VPS (Production)
   → git pull
   → docker-compose -f devops/docker/docker-compose.prod.yml up -d --build
   → Xong. API chạy tại port 8000

Các mẫu triển khai

Code mẫu:

• references/Dockerfile — Multi-stage build cho Python + Playwright
• references/docker-compose.dev.yml — Dev: Redis + App, hot reload
• references/docker-compose.prod.yml — Prod: healthcheck, restart, volumes
• references/dockerignore — File .dockerignore chuẩn
• references/env-example — Mẫu file .env

Quy tắc

• LUÔN dùng multi-stage build (giảm image size)
• LUÔN có healthcheck cho mọi service
• LUÔN tách dev/prod compose (khác config, khác volumes)
• KHÔNG BAO GIỜ commit .env thật → chỉ commit .env.example
• LUÔN có .dockerignore (loại .git, node_modules, pycache, .env)
• Tạo user non-root trong Dockerfile (bảo mật)
• Volumes cho data quan trọng (Redis, uploads) → không mất khi rebuild
• depends_on + condition: service_healthy → đảm bảo thứ tự khởi động
• LUÔN chạy local thành công trước khi push lên prod

Kết hợp với skills khác

| Cần | Skill | |-----|-------| | Xử lý đa luồng trong container | concurrency-engine | | Quản lý account pool | account-pool-manager | | API endpoints | rest-api-standard |