Next.js auf Nodion deployen

Next.js Schritt für Schritt deployen

1. Lockfile und die üblichen Skripte behalten Committe package-lock.json, yarn.lock, pnpm-lock.yaml oder bun.lock; ohne Lockfile scheitert der Build. next start lauscht auf dem PORT, den Nodion setzt, die Standard-Skripte funktionieren also unverändert. package.json

   "scripts": {
     "build": "next build",
     "start": "next start"
   }

2. App anlegen Lege im Dashboard eine Application aus deinem GitHub-, GitLab-, Bitbucket- oder Gitea-Repository an, wähle Branch und Region EU Central. Lass die Build-Strategie auf Buildpacks; liegt ein Dockerfile im Repository, wählt das Formular stattdessen Dockerfile.
3. Environment-Variablen setzen Alles, was next build liest, etwa NEXT_PUBLIC_*, braucht auf dem Tab Environment das Häkchen Build; alle anderen Variablen gibt es nur zur Laufzeit. API-Keys markierst du als Secret.
4. PostgreSQL anhängen und Migrationen ausführen Lege eine Datenbank in derselben Region an und hänge sie auf dem Tab Environment an; die App bekommt beim nächsten Deploy DATABASE_URL. Eine release:-Zeile in einer Procfile läuft bei jedem Build einmal, bevor die neue Version startet. Dein Migrations-Tool gehört in dependencies: Dev-Dependencies werden nach dem Build entfernt. Procfile

   release: npm run migrate

5. Pushen und deployen Jeder Push auf den Branch baut ein neues Release. Der Traffic wechselt, sobald es auf / mit 2xx oder 3xx antwortet; scheitert der Release-Schritt, bleibt die laufende Version live.

Gut zu wissen

• Statischer ExportMit output: 'export' in next.config liefert Nodion out/ über einen statischen Webserver mit index.html-Fallback aus. Es läuft kein Node-Server, die kleinste Größe reicht.
• Health-Check-PfadAntwortet / mit 401 oder 404, trag in den App-Einstellungen einen Health-Check-Pfad ein, der 200 liefert, zum Beispiel einen Route Handler unter /api/health.
• MonoreposSetz das Base Directory auf die Next.js-App. Der Build sieht nur dieses Verzeichnis, das Lockfile muss also darin liegen.

Was Nodion für dich betreibt

• Deploys ohne Downtime Push auf deinen Branch und Nodion baut ein neues Release. Der Traffic wechselt erst, wenn die neuen Instanzen ihren Health Check bestehen; ein fehlgeschlagenes Release lässt das laufende stehen. Apps mit lokalem Volume starten stattdessen neu, weil die Disk zu einer Instanz gehört.
• Datenbanken neben der App Managed PostgreSQL, pgvector, MySQL, Valkey und ClickHouse in derselben Region. Angehängte Datenbanken kommen als DATABASE_URL, REDIS_URL oder CLICKHOUSE_URL in die App.
• Previews pro Pull Request Schalte Previews ein, und Pull Requests aus deinem Repository bekommen eine eigene App mit eigener URL und frischen, leeren Datenbanken, automatisch oder per Hand angelegt. Forks und Bot-Pull-Requests werden übersprungen.
• Worker, Cron Jobs und Skalierung Worker laufen als weitere Prozesse derselben App, Jobs planst du auf dem Tab Cron, und jeden Prozess skalierst du auf bis zu 16 Instanzen.
• Release-Schritt Mit Buildpacks läuft eine release:-Zeile in der Procfile bei jedem neuen Build. Dockerfile-Apps sowie Redeploys und Rollbacks auf ein früheres Image nutzen einen Release Command, der an der App selbst gesetzt ist; er hat auch Vorrang vor der Procfile-Zeile. Bei statischen Sites läuft ein Release-Schritt in einem Image, das nur die gebauten Dateien enthält.
• Logs und Metriken Build-, Release- und Laufzeit-Logs sowie CPU-, Speicher-, Disk- und Netzwerk-Metriken für jede Instanz im Dashboard.
• Domains und HTTPS Ein Default-Hostname mit HTTPS ab dem ersten Deploy; deine eigenen Domains bekommen automatisch Zertifikate.

Weiterlesen

• Vercel-Alternativen in Europa: 5 Optionen für Next.js Functions am Edge oder ein dauerhaft laufender Node.js-Server neben der Datenbank: fünf Vercel-Alternativen für Next.js, verglichen nach Laufzeitmodell und Standort.
• Preview-Environments erklärt: eine App pro Pull Request Eine laufende Kopie deiner App für jeden Pull Request: wofür Preview-Environments gut sind, wo es knifflig wird und wie Nodion sie handhabt.

Next.js auf Nodion: Fragen und Antworten