আপনি কীভাবে FastAPI অ্যাপ্লিকেশনটি উৎপাদনে স্থাপন করবেন?

Question

Accepted Answer

FastAPI একটি **ASGI** অ্যাপ্লিকেশন, তাই উৎপাদন স্থাপনা একটি ASGI সার্ভার ব্যবহার করে — সাধারণত **Uvicorn** (প্রায়শই **Gunicorn** দ্বারা একাধিক worker এর জন্য পরিচালিত), একটি রিভার্স প্রক্সি যেমন nginx এর পিছনে। কন্টেইনারাইজেশন (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).
```

## অ্যাপ্লিকেশন Docker করা (সাধারণ)

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

একটি কন্টেইনার অ্যাপ্লিকেশন এবং এর নির্ভরতা প্যাকেজ করে পরিবেশ জুড়ে সামঞ্জস্যপূর্ণ স্থাপনার জন্য (তারপর 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)
```

## অ্যাসিঙ্ক এবং স্টেটলেসনেস

```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 worker** (সমস্ত CPU কোর ব্যবহার করে, যেহেতু প্রতিটি worker তার নিজস্ব ইভেন্ট লুপ চালায়), সাধারণত TLS এবং লোড ব্যালান্সিংয়ের জন্য nginx এর পিছনে। **কন্টেইনারাইজেশন (Docker)** সামঞ্জস্যপূর্ণ, পোর্টেবল স্থাপনার জন্য আধুনিক সাধারণ পদ্ধতি।

সার্ভার সেটআপের বাইরে, উৎপাদন চেকলিস্ট নিরাপত্তা এবং নির্ভরযোগ্যতা-সংক্রান্ত উদ্বেগ কভার করে: পরিবেশ ভেরিয়েবলের মাধ্যমে কনফিগারেশন এবং সিক্রেট (কখনও কোডে নয়), HTTPS, সঠিক ডাটাবেস মাইগ্রেশন এবং পুলিং সহ, যথাযথ CORS, লগিং এবং মনিটরিং, পটভূমি কাজের জন্য আলাদা worker সেবা, এবং — স্কেলিংয়ের জন্য — একটি লোড ব্যালান্সারের পিছনে **একাধিক স্টেটলেস ইনস্ট্যান্স** চালানো (Redis এ স্থিতি রাখা, প্রক্রিয়া মেমরিতে নয়)।

সঠিক ASGI সার্ভার স্ট্যাক, কন্টেইনারাইজেশন, একাধিক worker, এবং উৎপাদন শক্তিশালীকরণের সাথে FastAPI স্থাপন করা জানা সিনিয়র-স্তরের জ্ঞান, কারণ প্রতিটি প্রকৃত FastAPI অ্যাপ্লিকেশন কর্মক্ষম, সুরক্ষিত এবং স্কেলেবল হওয়ার জন্য সঠিকভাবে স্থাপন করা আবশ্যক — এটি উৎপাদন API চালানোর জন্য একটি ঘন ঘন-প্রাসঙ্গিক, পেশাদারভাবে-অপরিহার্য বিষয় করে তোলে।