FastAPI uygulamasını production ortamına nasıl deploy edersiniz?

Question

Accepted Answer

FastAPI bir **ASGI** uygulamasıdır, bu nedenle production deployment ASGI sunucusu kullanır — tipik olarak **Uvicorn** (çoğunlukla **Gunicorn** tarafından birden fazla worker için yönetilen), nginx gibi ters proxy'nin arkasında. Containerization (Docker) modern yaygın yaklaşımdır.

## Production sunucu yığını

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

## Uygulamayı Dockerize etme (yaygın)

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

Bir konteyner, uygulamayı ve bağımlılıklarını ortamlar arasında tutarlı deployment için paketler (ardından Kubernetes, ECS veya Railway/Render/Fly gibi PaaS üzerinde çalıştırılır).

## Production kontrol listesi

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

## Neden önemli

FastAPI'ı doğru şekilde deploy etmek, uygulamaları production ortamına taşımak için gereklidir ve geliştirme kurulumundan farklı olan **ASGI** doğasına özel önemli hususlar içerir.

Production sunucu yığınını anlamak temeldir: geliştirme sunucusu (`uvicorn --reload`) production için değildir, bu nedenle uygulamayı ASGI sunucusu aracılığıyla çalıştırırsınız — birden fazla işlem için **Gunicorn tarafından yönetilen Uvicorn worker'ları** (her worker kendi event loop'unu çalıştırdığından tüm CPU çekirdeğlerini kullanan), TLS ve yük dengeleme için tipik olarak nginx'in arkasında. **Containerization (Docker)** tutarlı, taşınabilir deploymentler için modern yaygın yaklaşımdır.

Sunucu kurulumunun ötesinde, production kontrol listesi güvenlik ve güvenilirlik açısından kritik hususları kapsar: ortam değişkenleri aracılığıyla konfigürasyon ve sırlar (asla kodda değil), HTTPS, gerçek bir veritabanı migration ve pooling ile, uygun CORS, logging ve monitoring, background işleri için ayrı worker servisleri ve — ölçeklendirme için — yük dengeleyicinin arkasında çalışan **birden fazla stateless örnek** (durumu Redis'te tutma, process belleğinde değil).

FastAPI'ı doğru ASGI sunucu yığını, containerization, birden fazla worker ve production hardening ile deploy etmeyi bilmek önemli senior seviye bilgisidir, çünkü her gerçek FastAPI uygulaması performanslı, güvenli ve ölçeklenebilir olması için doğru şekilde deploy edilmelidir — bu konuyu sık ilgili, profesyonelce gerekli bir konu haline getirir.