Jak nasadíte aplikaci FastAPI do produkce?

Question

Accepted Answer

FastAPI je aplikace **ASGI**, takže produkční nasazení používá ASGI server — obvykle **Uvicorn** (často spravovaný pomocí **Gunicorn** pro více workerů), za reverzní proxy jako nginx. Kontejnerizace (Docker) je moderní běžný přístup.

## Produkční zásobník serverů

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

## Dockerizace aplikace (běž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"]
```

Kontejner balí aplikaci a její závislosti pro konzistentní nasazení v různých prostředích (poté spustit na Kubernetes, ECS nebo PaaS jako Railway/Render/Fly).

## Produkční kontrolní seznam

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

## Asynchronizace a bezstavovost

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

## Proč je to důležité

Správné nasazení FastAPI je nezbytné pro uvedení aplikací do produkce a zahrnuje důležité úvahy specifické pro jeho povahu **ASGI**, které se liší od vývojového nastavení.

Porozumění produkčnímu zásobníku serverů je základní: vývojový server (`uvicorn --reload`) není pro produkci, takže aplikaci spustíte prostřednictvím ASGI serveru — **workeři Uvicorn spravovaní Gunicornem** pro více procesů (využívání všech jader CPU, protože každý worker spouští svou vlastní event loop), obvykle za nginx pro TLS a vyrovnávání zatížení. **Kontejnerizace (Docker)** je moderním běžným přístupem pro konzistentní, přenosná nasazení.

Beyond setup serveru, produkční kontrolní seznam zahrnuje obavy kritické pro bezpečnost a spolehlivost: konfigurace a tajemství prostřednictvím proměnných prostředí (nikdy v kódu), HTTPS, skutečná databáze s migracemi a poolingem, správné CORS, logování a monitorování, oddělené služby workerů pro úlohy na pozadí a — pro škálování — spouštění **více bezstavových instancí** za vyrovnávačem zatížení (uchování stavu v Redis, ne v paměti procesu).

Vědět, jak nasadit FastAPI se správným zásobníkem ASGI serveru, kontejnerizací, více workery a produkčním zpevněním, je důležité znalosti na úrovni senior, protože každá skutečná aplikace FastAPI musí být nasazena správně, aby byla výkonná, bezpečná a škálovatelná — čímž se z tohoto tématu stává často relevantní, profesionálně nezbytné téma pro dodávání produkčních API.