دستاویزات/سیکیورٹی اور تعیناتی۔

تعینات کریں۔

دو حکم: nx build نمونے تیار کرتا ہے، nx start ان کی خدمت کرتا ہے۔

شروع کرنے سے پہلے: ایک پروجیکٹ جو مقامی طور پر nx build کے ساتھ بناتا ہے، اور - کلائنٹ کے صفحات کے لیے - فرنٹ اینڈ ٹول چین جو nx new انسٹال ہوتا ہے۔

nx buildnx start --host 0.0.0.0 --port 8000

رن ٹائم کی ضرورت ہے صرف Python۔ Uvicorn مرتب کردہ ایپ اور جامد اثاثوں کو پیش کرتا ہے۔ کوئی نوڈ عمل اور کوئی Vite عمل شامل نہیں ہے۔

تعمیر کیا پیدا کرتی ہے۔

__nexy__/ مرتب شدہ روٹ ماڈیولز، __nexy__/client/ کے تحت کلائنٹ بنڈل، اور فریم ورک روٹس کے لیے پہلے سے پیش کردہ HTML پر مشتمل ہے۔ پروجیکٹ کو کاپی کریں - سورس پلس __nexy__/ - یا تصویر کے اندر بنائیں۔

Docker

تعمیراتی مرحلے کو نوڈ (Vite کے لیے) اور Python (مرتب کے لیے) کی ضرورت ہے۔ رن ٹائم مرحلے کو صرف Python کی ضرورت ہے۔

FROM node:22-bookworm-slim AS buildWORKDIR /app COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uvCOPY pyproject.toml uv.lock ./RUN uv sync --frozen --no-install-project COPY . .RUN uv sync --frozen && uv run nx build FROM python:3.13-slimWORKDIR /appCOPY --from=build /app /appENV PATH="/app/.venv/bin:$PATH" EXPOSE 8000CMD ["nx", "start", "--host", "0.0.0.0", "--port", "8000"]

uv ایک منظم Python حاصل کرتا ہے جب بنیادی تصویر میں کوئی نہیں ہوتا ہے، یہی وجہ ہے کہ تعمیر کا مرحلہ نوڈ امیج سے شروع ہوسکتا ہے۔

ایک ریورس پراکسی کے پیچھے

لوکل ہوسٹ پر nx start چلائیں اور Nginx، Caddy یا پلیٹ فارم پراکسی کو TLS کو ختم کرنے دیں:

nx start --host 127.0.0.1 --port 8000

اس بات کو یقینی بنائیں کہ اگر آپ SOCKET ہینڈلرز استعمال کرتے ہیں تو پراکسی فارورڈز WebSocket کو اپ گریڈ کرتا ہے، اور یہ کہ یہ اصل میزبان کو فارورڈ کرتا ہے - FastAPI اس سے مطلق یو آر ایل بناتا ہے۔

صحت کی جانچ

async def GET():    return {"status": "ok"}

from nexy.decorators import Controller  @Controller("/health")class HealthController:    async def get(self):        return {"status": "ok"}

بلٹ ان اینڈ پوائنٹس

لوڈ بیلنس کرنے والا یا Kubernetes دو سوالات پوچھتا ہے: کیا یہ عمل زندہ ہے، اور کیا اس سے ٹریفک موصول ہو سکتا ہے؟ سیٹ useHealth اور Nexy دونوں جواب دیتا ہے، بغیر ہینڈلر فائل کے اور کوئی کنٹرولر نہیں:

from nexy.core.models import NexyConfigModel  class NexyConfig(NexyConfigModel):    useHealth = True

Nexy اس بات کی ضمانت دیتا ہے کہ /health/ready سرور کے آغاز اور بند ہونے کی پیروی کرتا ہے۔

Nexy اس بات کی ضمانت دیتا ہے کہ دونوں اینڈ پوائنٹس رسائی لاگ سے باہر اور OpenAPI اسکیما سے باہر رہیں۔

Nexy اس بات کی ضمانت دیتا ہے کہ دونوں اینڈ پوائنٹس useTrustedHost اور useHTTPSRedirect سے پہلے جواب دیتے ہیں، لہذا پوڈ کے پتے پر HTTP پر بھیجی جانے والی تحقیقات سے انکار نہیں کیا جاتا ہے۔

کنونشن کے مطابق آپ اپنے اپنے راستوں کو بند رکھتے ہیں /health/live اور /health/ready جبکہ useHealth آن ہے: Nexy جواب کے اختتامی نکات پہلے۔ useHealth بذریعہ ڈیفالٹ False ہے، لہٰذا جو پروجیکٹ اسے سیٹ نہیں کرتا ہے وہ دونوں راستے رکھتا ہے۔

آپ کی درخواست یہ جانچنے کی ذمہ دار ہے کہ یہ کس چیز پر منحصر ہے: /health/ready سرور کے لائف سائیکل کی رپورٹ کرتا ہے، نہ کہ ڈیٹا بیس کی حالت۔

ان کی طرف ایک Kubernetes Deployment کی تحقیقات کی طرف اشارہ کریں:

apiVersion: apps/v1kind: Deploymentmetadata:  name: appspec:  replicas: 2  selector:    matchLabels:      app: app  template:    metadata:      labels:        app: app    spec:      containers:        - name: app          image: registry.example.com/app:1.0          ports:            - containerPort: 8000          livenessProbe:            httpGet:              path: /health/live              port: 8000            periodSeconds: 10          readinessProbe:            httpGet:              path: /health/ready              port: 8000            periodSeconds: 5

جامد ہوسٹنگ

ہر صفحہ HTML ہے، لیکن Nexy روٹنگ اور API ہینڈلرز کے لیے ایک سرور فرض کرتا ہے۔

چیک لسٹ

• nx build CI میں، ان راستوں کے لیے کوئی انتباہ نہیں جو آپ سرور پر پیش کرنے کی توقع کرتے ہیں
• nx start کوڈ 1 کے ساتھ باہر نکلتا ہے، اور کچھ بھی شروع نہیں ہوتا ہے، جب روٹ فائل لوڈ نہیں ہو سکتی
• NEXY_ACTION_SECRET سیٹ، یا __nexy__/action.key تعمیر کے ساتھ رکھا گیا ہے۔
• useDocs = False پیداوار میں اگر API اسکیما عوامی نہیں ہونا چاہئے۔
• [] useTrustedHost اور useHTTPSRedirect عوامی تعیناتیوں کے لیے مقرر
• useHealth = True جب لوڈ بیلنسر یا کبرنیٹس ایپ کی تحقیقات کرتا ہے۔
• __nexy__/ کا ارتکاب نہیں کیا۔

اگلے اقدامات

• کنفیگ : HTTPS، قابل اعتماد میزبان، سیشن
• فرنٹ اینڈ : کیا Vite بناتا ہے۔
• ٹیسٹنگ: CI میں چلانے کے لیے کمانڈز

صفحہ Markdown کے طور پر کاپی کریں GitHub پر ترمیم کریں