Kako uvedete FastAPI aplikacijo v produkcijo?

Question

Accepted Answer

FastAPI je **ASGI** aplikacija, zato produkcijska uvedba uporablja ASGI strežnik — običajno **Uvicorn** (pogosto upravljen z **Gunicorn** za več delavcev), za katerim je obrnjen proxy kot nginx. Vsebnikovanje (Docker) je sodoben pristop.

## Sklad produkcijskega strežnika

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

## Vsebnikovanje aplikacije (pogosto)

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

Vsebnik pakira aplikacijo in njene odvisnosti za doslednost uvedbe v različnih okoljih (nato zaženite na Kubernetes, ECS ali PaaS kot Railway/Render/Fly).

## Produkcijski checklist

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

## Asinkrioni in breztilnost

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

## Zakaj je to pomembno

Pravilna uvedba FastAPI je bistvenega pomena za proizvodnjo aplikacij in vključuje važne razmotreške, specifične za njeno **ASGI** naravo, ki se razlikujejo od razvojne postavitve.

Razumevanje složa produkcijskega strežnika je temelj: razvojni strežnik (`uvicorn --reload`) ni namenjen produkciji, zato aplikacijo zaženete prek ASGI strežnika — **Uvicorn delavce upravljane z Gunicorn** za več procesov (izkoriščanje vseh CPP jeder, saj vsak delavec poganja lastno zanko dogodkov), običajno za nginx za TLS in uravnotežitev obremenitve. **Vsebnikovanje (Docker)** je sodoben pristop za dosledne in prenosljive uvedbe.

Poleg postavitve strežnika produkcijski checklist obsega varnostne in zanesljivostne kritične vidike: konfiguracija in skrivnosti prek spremenljivk okolja (nikoli v kodi), HTTPS, pravo bazo podatkov z migracijo in baraž, pravilen CORS, beleženje in spremljanje, ločene delavske storitve za ozadinske naloge, in — za skalabilnost — izvajanje **več breztilnih primerov** za uravnoteženjem obremenitve (vednost v Redis, ne v pomnilniku procesa).

Znanje, kako uvedeti FastAPI s pravim ASGI slojom strežnika, vsebnikovanja, več delavcev in produkcijskim utrjevanjem, je pomembno vedenje na visokem nivoju, saj mora biti vsaka resnična FastAPI aplikacija pravilno uvedena, da je učinkovita, varna in skalabilna — to pa je pogosto relevantna in strokovno bistvena tema za dostavljanje produkcijskih API-jev.