ਤੁਸੀਂ FastAPI ਐਪ ਨੂੰ ਪ੍ਰੋਡਕਸ਼ਨ ਵਿੱਚ ਕਿਵੇਂ ਤਾਇਨਾਤ ਕਰਦੇ ਹੋ?

Question

Accepted Answer

FastAPI ایک **ASGI** ایپلیکیشن ہے، اس لیے پروڈکشن میں تعینات ایک ASGI سرور استعمال کرتا ہے — عام طور پر **Uvicorn** (اکثر **Gunicorn** کے ذریعے متعدد workers کے لیے منظم)، nginx جیسے ریورس پراکسی کے پیچھے۔ Containerization (Docker) جدید نقطہ نظر ہے۔

## پروڈکشن سرور اسٹیک

```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 ایپ اور اس کے dependencies کو پیکج کرتا ہے تاکہ ماحول میں مطابقت پذیر تعینات ہو (پھر Kubernetes، ECS، یا Railway/Render/Fly جیسے PaaS پر چلائیں)۔

## پروڈکشن چیک لسٹ

```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 اور 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
```

## یہ اہم کیوں ہے

FastAPI کو صحیح طریقے سے تعینات کرنا ایپلیکیشنز کو پروڈکشن میں لے جانے کے لیے ضروری ہے، اور اس میں اس کی **ASGI** نوعیت سے متعلق اہم نکات شامل ہیں جو ترقیاتی سیٹ اپ سے مختلف ہیں۔

پروڈکشن سرور اسٹیک کو سمجھنا بنیادی ہے: ترقیاتی سرور (`uvicorn --reload`) پروڈکشن کے لیے نہیں ہے، اس لیے آپ ایپ کو ASGI سرور کے ذریعے چلاتے ہیں — **Gunicorn کے ذریعے منظم Uvicorn workers** متعدد processes کے لیے (تمام CPU cores استعمال کرتے ہوئے، کیونکہ ہر worker اپنا event loop چلاتا ہے)، عام طور پر nginx کے پیچھے TLS اور load balancing کے لیے۔ **Containerization (Docker)** مطابقت پذیر، portable تعینات کے لیے جدید نقطہ نظر ہے۔

سرور سیٹ اپ سے ماوراء، پروڈکشن چیک لسٹ حفاظت اور قابل اعتبار اہم نکات کا احاطہ کرتی ہے: ماحول کے متغیرات کے ذریعے configuration اور secrets (کبھی کوڈ میں نہیں)، HTTPS، حقیقی ڈیٹا بیس migration اور pooling کے ساتھ، صحیح CORS، logging اور monitoring، background کاموں کے لیے الگ worker سروسز، اور — اسکیلنگ کے لیے — **متعدد stateless instances** کو load balancer کے پیچھے چلانا (state کو Redis میں رکھتے ہوئے، process memory میں نہیں)۔

یہ جاننا کہ FastAPI کو صحیح ASGI سرور اسٹیک، containerization، متعدد workers، اور پروڈکشن hardening کے ساتھ کیسے تعینات کریں، اہم senior-level علم ہے، کیونکہ ہر حقیقی FastAPI ایپلیکیشن کو درست طریقے سے تعینات کیا جانا ضروری ہے تاکہ وہ کارکردگی، حفاظت، اور scalability کے لحاظ سے بہترین ہو — یہ pروڈکشن APIs کو شپ کرنے کے لیے ایک بار بار متعلقہ، پیشہ ورانہ طور پر ضروری موضوع بناتا ہے۔