Bagaimana anda menggunakan (deploy) aplikasi FastAPI ke produksi?

Question

Accepted Answer

FastAPI ialah aplikasi **ASGI**, jadi penggunaan produksi menggunakan pelayan ASGI — biasanya **Uvicorn** (selalunya diurus oleh **Gunicorn** untuk berbilang pekerja/workers), di belakang proksi songsang (reverse proxy) seperti nginx. Pengkontenaan (Docker) ialah pendekatan moden yang biasa.

## Timbunan pelayan produksi

```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).
```

## Mengdokerkan aplikasi (biasa)

```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"]
```

Satu kontena membungkus aplikasi dan kebergantungannya untuk penggunaan yang konsisten merentas persekitaran (kemudian dijalankan pada Kubernetes, ECS, atau PaaS seperti Railway/Render/Fly).

## Senarai semak produksi

```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 dan ketakberkeadaan (statelessness)

```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
```

## Mengapa ia penting

Menggunakan FastAPI dengan betul adalah penting untuk membawa aplikasi ke produksi, dan ia melibatkan pertimbangan penting khusus kepada sifat **ASGI**-nya yang berbeza daripada persediaan pembangunan.

Memahami timbunan pelayan produksi adalah asas: pelayan pembangunan (`uvicorn --reload`) bukan untuk produksi, jadi anda menjalankan aplikasi melalui pelayan ASGI — **pekerja Uvicorn yang diurus oleh Gunicorn** untuk berbilang proses (memanfaatkan semua teras CPU, kerana setiap pekerja menjalankan gelung peristiwanya sendiri), biasanya di belakang nginx untuk TLS dan pengimbangan beban. **Pengkontenaan (Docker)** ialah pendekatan moden yang biasa untuk penggunaan yang konsisten dan mudah alih.

Selain persediaan pelayan, senarai semak produksi merangkumi kebimbangan kritikal keselamatan dan kebolehpercayaan: konfigurasi dan rahsia melalui pemboleh ubah persekitaran (jangan sekali-kali dalam kod), HTTPS, pangkalan data sebenar dengan migrasi dan pengumpulan, CORS yang betul, pengelogan dan pemantauan, perkhidmatan pekerja berasingan untuk kerja latar belakang, dan — untuk penskalaan — menjalankan **berbilang instans tanpa keadaan (stateless)** di belakang pengimbang beban (mengekalkan keadaan dalam Redis, bukan ingatan proses).

Mengetahui cara menggunakan FastAPI dengan timbunan pelayan ASGI yang betul, pengkontenaan, berbilang pekerja, dan pengukuhan produksi ialah pengetahuan peringkat senior yang penting, kerana setiap aplikasi FastAPI sebenar mesti digunakan dengan betul untuk menjadi berprestasi, selamat, dan boleh diskala — menjadikan ini topik yang kerap relevan dan penting dari segi profesional untuk menghantar API produksi.