Docs/Sécurité et déploiement

Déployer

Deux commandes : nx build produit les artefacts, nx start les sert.

Avant de commencer : un projet qui se construit localement avec nx build et - pour les pages client - la chaîne d'outils frontend installée par nx new.

nx buildnx start --host 0.0.0.0 --port 8000

Le runtime n’a besoin que de Python. Uvicorn sert l'application compilée et les actifs statiques ; aucun processus Node et aucun processus Vite ne sont impliqués.

Ce que produit la construction

__nexy__/ contient les modules de route compilés, le bundle client sous __nexy__/client/ et le code HTML pré-rendu pour les routes du framework. Copiez le projet - source plus __nexy__/ - ou construisez à l'intérieur de l'image.

Docker

L'étape de construction a besoin de Node (pour Vite) et de Python (pour le compilateur). L'étape d'exécution n'a besoin que de 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 récupère un Python géré lorsque l'image de base n'en a pas, c'est pourquoi l'étape de construction peut démarrer à partir d'une image Node.

Derrière un proxy inverse

Exécutez nx start sur localhost et laissez Nginx, Caddy ou le proxy de la plateforme mettre fin à TLS :

nx start --host 127.0.0.1 --port 8000

Assurez-vous que le proxy transfère les mises à niveau de WebSocket si vous utilisez les gestionnaires SOCKET et qu'il transfère l'hôte d'origine - FastAPI crée des URL absolues à partir de celui-ci.

Bilan de santé

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

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

Points de terminaison intégrés

Un équilibreur de charge ou Kubernetes pose deux questions : le processus est-il vivant et peut-il recevoir du trafic ? Set useHealth et Nexy répondent aux deux, sans fichier de gestionnaire ni contrôleur :

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

Nexy garantit que /health/ready suit le démarrage et l'arrêt du serveur.

Nexy garantit que les deux points de terminaison restent en dehors du journal d'accès et du schéma OpenAPI.

Nexy garantit que les deux points de terminaison répondent avant useTrustedHost et useHTTPSRedirect, donc une sonde envoyée via HTTP à l'adresse d'un pod n'est pas refusée.

Par convention, vous gardez vos propres routes désactivées /health/live et /health/ready pendant que useHealth est activé : les points finaux de Nexy répondent en premier. useHealth est False par défaut, donc un projet qui ne le définit pas conserve les deux chemins.

Votre application est chargée de vérifier de quoi elle dépend : /health/ready rapporte le cycle de vie du serveur, pas l'état d'une base de données.

Pointez vers eux les sondes d'un 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

Hébergement statique

Chaque page est HTML, mais Nexy suppose un serveur pour le routage et pour les gestionnaires d'API.

Liste de contrôle

• nx build dans CI, aucun avertissement pour les routes que vous prévoyez d'afficher sur le serveur
• nx start se termine avec le code 1 et ne démarre rien lorsqu'un fichier de route ne peut pas se charger
• NEXY_ACTION_SECRET défini, ou __nexy__/action.key conservé avec la build
• useDocs = False en production si le schéma API ne doit pas être public
• useTrustedHost et useHTTPSRedirect définis pour les déploiements publics
• useHealth = True lorsqu'un équilibreur de charge ou Kubernetes sonde l'application
• __nexy__/ non engagé

Prochaines étapes

• Configuration : HTTPS, hôtes de confiance, sessions
• Frontend : ce que Vite construit
• Tests : les commandes à exécuter en CI

Copier la page en Markdown Modifier sur GitHub