Astro auf Nodion deployen

Astro Schritt für Schritt deployen

1. Lockfile committen und bauen Committe dein Lockfile; ohne Lockfile scheitert der Build. Nodion führt dein build-Skript aus und liefert dist/ über einen statischen Webserver aus. Es läuft kein Node.js-Server, eine statische Astro-Site braucht also keinen Adapter. package.json

   "scripts": {
     "dev": "astro dev",
     "build": "astro build"
   }

2. Build-Variablen markieren Ein statischer Build liest alle Variablen während astro build, setz für sie also auf dem Tab Environment das Häkchen Build. Im Server-Modus gilt das auch für PUBLIC_*-Variablen, die im Browser-Code landen.
3. Für SSR: den Node-Adapter hinzufügen Führ npx astro add node aus oder installier @astrojs/node selbst, nutz ihn im Standalone-Modus und setz output: 'server' (oder 'hybrid' unter Astro 4). Nodion startet nur dann einen Server, wenn astro.config.mjs, .js oder .ts diese Einstellung enthält; astro.config.mts liest Nodion nicht. astro und @astrojs/node gehören in dependencies, denn Dev-Dependencies werden nach dem Build entfernt. astro.config.mjs

   import { defineConfig } from "astro/config";
   import node from "@astrojs/node";
   
   export default defineConfig({
     output: "server",
     adapter: node({ mode: "standalone" }),
   });

4. Server auf allen Interfaces lauschen lassen Der Standalone-Server liest PORT, den Nodion setzt, und HOST. Setz auf dem Tab Environment HOST auf 0.0.0.0, damit der Server Verbindungen von außerhalb der Instanz annimmt, auch den Health Check. Nodion startet node ./dist/server/entry.mjs, außer die package.json hat ein start-Skript; ruft deins astro dev auf, entfern es.
5. App anlegen und pushen Lege im Dashboard eine Application aus deinem GitHub-, GitLab-, Bitbucket- oder Gitea-Repository in der Region EU Central an. Jeder Push baut ein neues Release, und der Traffic wechselt, sobald / mit 2xx oder 3xx antwortet.

Gut zu wissen

• On-Demand-Seiten brauchen output: 'server'Nodion entscheidet anhand der Einstellung output, nicht anhand des Adapters. Ein Projekt, das beim statischen Standard bleibt und einzelne Seiten mit export const prerender = false on demand rendert, läuft nicht als Server. Setz stattdessen output: 'server' und markiere die Seiten, die statisch bleiben sollen, mit export const prerender = true.
• Deine 404-SeiteFür Pfade, die es nicht gibt, antwortet der statische Server mit deiner index.html. Soll stattdessen die Seite erscheinen, die Astro aus src/pages/404.astro baut, leg eine static.toml mit fallback = "404.html" an. Das gilt nur für statischen Output: Mit einer static.toml liefert Nodion das Projekt immer als statische Dateien aus.

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

• 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.

Astro auf Nodion: Fragen und Antworten