คุณจะ deploy แอป FastAPI ขึ้น production อย่างไร?

Question

Accepted Answer

FastAPI เป็นแอปพลิเคชันแบบ **ASGI** ดังนั้นการ deploy ขึ้น production จะใช้ ASGI server โดยทั่วไปคือ **Uvicorn** (ซึ่งมักถูกจัดการโดย **Gunicorn** เพื่อรันหลาย worker) อยู่หลัง reverse proxy อย่าง nginx การใช้ container (Docker) เป็นแนวทางสมัยใหม่ที่นิยมกัน

## production server stack

```bash
# ❌ the dev server (with --reload) is NOT for production
uvicorn main:app --reload

# ✅ production: Gunicorn managing multiple Uvicorn workers (uses all CPU cores)
gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000
# -w 4 → 4 worker processes (rule of thumb: ~2 × CPU cores)
```

```text
Client → NGINX (reverse proxy: TLS, static files, load balancing)
           → GUNICORN (process manager) → UVICORN workers (run the ASGI app)
Multiple workers let FastAPI use multiple CPU cores (each worker = one process).
```

## การ Dockerize แอป (วิธีที่นิยม)

```dockerfile
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["gunicorn", "main:app", "-w", "4", "-k", "uvicorn.workers.UvicornWorker", "--bind", "0.0.0.0:8000"]
```

Container จะรวมแอปและ dependency ของมันเข้าด้วยกันเพื่อให้ deploy ได้สอดคล้องกันในทุกสภาพแวดล้อม (จากนั้นจึงนำไปรันบน Kubernetes, ECS หรือ PaaS อย่าง Railway/Render/Fly)

## checklist สำหรับ production

```text
1. Config & secrets via environment variables (not in code); validate at startup
2. Multiple workers (Gunicorn + Uvicorn workers) for CPU utilization
3. HTTPS/TLS (at nginx or the platform/load balancer)
4. A real database (PostgreSQL) + connection pooling; run migrations (Alembic)
5. CORS configured to an allowlist (not "*") for browser clients
6. Logging + error monitoring (Sentry) + health-check endpoint
7. A separate worker service (Celery/ARQ) + broker (Redis) for background jobs
8. Horizontal scaling: multiple instances behind a load balancer — keep app STATELESS
   (sessions/state in Redis, not process memory)
```

## Async และความเป็น stateless

```text
✓ Each worker runs its own event loop → workers give parallelism, async gives concurrency
✓ Keep the app STATELESS so you can run many instances behind a load balancer
```

## ทำไมจึงสำคัญ

การ deploy FastAPI อย่างถูกต้องเป็นสิ่งจำเป็นสำหรับการนำแอปพลิเคชันขึ้น production และเกี่ยวข้องกับข้อพิจารณาสำคัญที่เป็นเฉพาะของธรรมชาติแบบ **ASGI** ของมัน ซึ่งแตกต่างจากการตั้งค่าตอนพัฒนา

การเข้าใจ production server stack เป็นพื้นฐานสำคัญ: dev server (`uvicorn --reload`) ไม่ได้มีไว้สำหรับ production ดังนั้นคุณจึงต้องรันแอปผ่าน ASGI server — **Uvicorn workers ที่จัดการโดย Gunicorn** เพื่อให้มีหลาย process (ใช้งาน CPU core ทุกตัว เนื่องจากแต่ละ worker รัน event loop ของตัวเอง) โดยทั่วไปจะอยู่หลัง nginx สำหรับ TLS และ load balancing **การใช้ container (Docker)** เป็นแนวทางสมัยใหม่ที่นิยมสำหรับการ deploy ที่สอดคล้องและพกพาได้

นอกเหนือจากการตั้งค่า server แล้ว checklist สำหรับ production ยังครอบคลุมเรื่องที่สำคัญด้านความปลอดภัยและความน่าเชื่อถือ: การจัดการ configuration และ secrets ผ่าน environment variables (ไม่ใส่ในโค้ดเด็ดขาด), HTTPS, database จริงพร้อม migration และ pooling, การตั้งค่า CORS ที่เหมาะสม, logging และ monitoring, worker service แยกต่างหากสำหรับ background job และ — สำหรับการ scale — การรัน **หลาย instance ที่เป็น stateless** อยู่หลัง load balancer (เก็บ state ไว้ใน Redis ไม่ใช่ใน process memory)

การรู้วิธี deploy FastAPI ด้วย ASGI server stack ที่เหมาะสม, การใช้ container, หลาย worker และการเสริมความแข็งแกร่งสำหรับ production เป็นความรู้ระดับ senior ที่สำคัญ เพราะทุกแอปพลิเคชัน FastAPI จริงต้องถูก deploy อย่างถูกต้องจึงจะมีประสิทธิภาพ ปลอดภัย และ scale ได้ — ทำให้เรื่องนี้เป็นหัวข้อที่เกี่ยวข้องบ่อยและจำเป็นในเชิงวิชาชีพสำหรับการส่งมอบ production API