Next.js-App erstellen und bereitstellen

Das Erstellen einer Next.js-Webanwendung ist nur der erste Schritt, um Ihre Ideen online zu bringen. Damit Ihre App schnell, responsiv und für Nutzer leicht zu finden ist, müssen Sie die richtige Bereitstellungseinrichtung auswählen.

Ganz gleich, ob Sie KI-Webprototypen mit Prompts in natürlicher Sprache erstellen oder Full-Stack-Codebasen bereitstellen, die aus Tools wie Claude Code oder Replit exportiert wurden – moderne Cloud-Plattformen bieten reibungslose Hosting-Möglichkeiten. In diesem Leitfaden wird erläutert, wie Next.js funktioniert, welche wichtigen Aspekte bei der Rendering-Architektur zu beachten sind und wie Sie Ihre Anwendung mithilfe der kostenlosen Starter-Stufe in einer verwalteten Infrastruktur bereitstellen.

Next.js-Anwendung in Cloud Run ausführen

Was ist Next.js?

Next.js ist ein Open-Source-React-Framework, mit dem Entwickler Full-Stack-Webanwendungen erstellen können. Während Standard-React-Anwendungen normalerweise clientseitig im Webbrowser ausgeführt werden, kombiniert Next.js clientseitige Interaktivität mit serverseitigem Rendering.

Durch die automatische Verarbeitung von Seitenrouting, Serverkomponenten und Asset-Optimierung ermöglicht Next.js Entwicklern und Vibe-Codern, kreative Konzepte bei minimaler Konfiguration in produktionsreife Webanwendungen umzusetzen.

Klassisches React im Vergleich zu Next.js

Die Wahl zwischen Standard-React und Next.js hängt von Ihren Rendering-Anforderungen, der Sichtbarkeit in Suchmaschinen und Ihren Backend-Anforderungen ab:

Funktion

React (Standard)

Next.js

Rendering-Architektur

Clientseitiges Rendering (CSR)

Serverseitiges Rendering (SSR), statische Websitegenerierung (SSG) und React Server-Komponenten

Suchmaschinenoptimierung (SEO)

Kann zusätzliche Prerendering-Konfiguration erfordern

Suchmaschinenfreundlich durch serverseitig gerendertes HTML

Erster Seitenaufbau

Auf Geräten mit geringer Leistung langsamer, da die JavaScript-Bundles des Clients groß sind

Schnellere Erstanzeige durch schlankes, serverseitig gerendertes HTML

Routing-Mechanismus

Erfordert Routing-Bibliotheken von Drittanbietern (z. B. React Router)

Integrierte dateisystembasierte Weiterleitung über den App Router

Full-Stack-Funktionen

Nur Frontend; erfordert einen separaten Backend-Dienst

Integrierte API-Routen-Handler und Serveraktionen

Funktion

React (Standard)

Next.js

Rendering-Architektur

Clientseitiges Rendering (CSR)

Serverseitiges Rendering (SSR), statische Websitegenerierung (SSG) und React Server-Komponenten

Suchmaschinenoptimierung (SEO)

Kann zusätzliche Prerendering-Konfiguration erfordern

Suchmaschinenfreundlich durch serverseitig gerendertes HTML

Erster Seitenaufbau

Auf Geräten mit geringer Leistung langsamer, da die JavaScript-Bundles des Clients groß sind

Schnellere Erstanzeige durch schlankes, serverseitig gerendertes HTML

Routing-Mechanismus

Erfordert Routing-Bibliotheken von Drittanbietern (z. B. React Router)

Integrierte dateisystembasierte Weiterleitung über den App Router

Full-Stack-Funktionen

Nur Frontend; erfordert einen separaten Backend-Dienst

Integrierte API-Routen-Handler und Serveraktionen

Traditionelles Anwendungshosting im Vergleich zu serverlosen Containern

Bei der Vorbereitung der Bereitstellung einer Next.js-Anwendung hat die Wahl der richtigen Rechenumgebung direkten Einfluss auf den Wartungsaufwand, die Skalierungsgeschwindigkeit und die Betriebskosten.

Feature

Virtuelle Maschinen (VPS/IaaS)


PaaS-/Buildpack-Plattformen


Serverlose Container (Cloud Run)


Infrastrukturverwaltung

Hoch; manuelle Betriebssystemupdates und Server-Patching

Vollständig verwaltete Plattformebene mit anbieterspezifischen Konventionen

Vollständig verwaltete Infrastruktur ohne Betriebssystemwartung

Verhalten von Autoscaling

Bereitstellung und Starten neuer virtueller Maschinen dauert mehrere Minuten

Schnelles Autoscaling, oft an gestaffelte Worker-Pläne oder Nebenläufigkeitslimits gebunden

Sofortiges anfragegesteuertes Autoscaling, einschließlich Skalierung auf null im inaktiven Zustand

Verpackungsformat

Roh-Build-Dateien oder PM2-Prozessmanager

Git-Repository-Integration mit proprietären Build-Systemen

Standard-OCI- (Open Container Initiative) und Docker-Container-Images

Kostenprofil für inaktive Ressourcen

Abrechnung rund um die Uhr, unabhängig vom eingehenden Traffic

Monatliche Grundgebühr oder strenge Ausführungslimits für kostenlose Stufen

Kostenloses Kontingent der Starter-Stufe oder sekundengenaue Abrechnung während aktiver Anfragen

Anbieterportabilität

Hoch, aber die Einrichtung kann schwierig zu replizieren sein

Niedrig; Konfigurationen basieren auf anbieterspezifischen Hosting-Regeln

Hoch; Standard-Container-Images können in jeder Cloud oder lokalen Umgebung ausgeführt werden

Feature

Virtuelle Maschinen (VPS/IaaS)


PaaS-/Buildpack-Plattformen


Serverlose Container (Cloud Run)


Infrastrukturverwaltung

Hoch; manuelle Betriebssystemupdates und Server-Patching

Vollständig verwaltete Plattformebene mit anbieterspezifischen Konventionen

Vollständig verwaltete Infrastruktur ohne Betriebssystemwartung

Verhalten von Autoscaling

Bereitstellung und Starten neuer virtueller Maschinen dauert mehrere Minuten

Schnelles Autoscaling, oft an gestaffelte Worker-Pläne oder Nebenläufigkeitslimits gebunden

Sofortiges anfragegesteuertes Autoscaling, einschließlich Skalierung auf null im inaktiven Zustand

Verpackungsformat

Roh-Build-Dateien oder PM2-Prozessmanager

Git-Repository-Integration mit proprietären Build-Systemen

Standard-OCI- (Open Container Initiative) und Docker-Container-Images

Kostenprofil für inaktive Ressourcen

Abrechnung rund um die Uhr, unabhängig vom eingehenden Traffic

Monatliche Grundgebühr oder strenge Ausführungslimits für kostenlose Stufen

Kostenloses Kontingent der Starter-Stufe oder sekundengenaue Abrechnung während aktiver Anfragen

Anbieterportabilität

Hoch, aber die Einrichtung kann schwierig zu replizieren sein

Niedrig; Konfigurationen basieren auf anbieterspezifischen Hosting-Regeln

Hoch; Standard-Container-Images können in jeder Cloud oder lokalen Umgebung ausgeführt werden

Wichtige Überlegungen beim Erstellen einer Next.js-App

Für die Erstellung einer produktionsreifen Next.js-Anwendung müssen grundlegende Architekturmuster berücksichtigt werden, die eine schnelle Leistung und stabile Verfügbarkeit gewährleisten:

Client- und Servergrenzen

Next.js verwendet standardmäßig React Server Components [Inferenz]. Serverkomponenten rufen Daten direkt ab, ohne umfangreiches JavaScript an den Browser zu senden, während interaktive UI-Elemente die Anweisung „use client“ verwenden [Inferenz]. Konzentrieren Sie sich bei Clientkomponenten auf interaktive UI-Aufgaben, damit Ihr Client-Bundle klein und schnell bleibt [Inferenz].

Client-Umgebungsvariablen

Um zu verhindern, dass private API-Schlüssel oder Datenbankanmeldedaten an den öffentlichen Browser weitergegeben werden, beschränkt Next.js den Browserzugriff auf Variablen mit dem Präfix NEXT_PUBLIC_. Private Server-Secrets sollten immer ohne Präfix verwendet und sicher in Umgebungskonfigurationen verwaltet werden.

Zustandslose serverlose Ausführung

Moderne serverlose Plattformen starten und beenden Containerinstanzen je nach eingehendem Traffic. Dateien, die direkt auf lokalen Containerlaufwerken gespeichert werden, gehen verloren, wenn Instanzen herunterskaliert oder neu bereitgestellt werden. Speichern Sie persistente Anwendungsdaten in verwalteten Cloud-Datenbanken wie Cloud Firestore oder Cloud SQL for PostgreSQL und speichern Sie Nutzer-Uploads in Cloud Storage.

Eigenständiges Output-Tracing

 Aktivieren Sie bei benutzerdefinierten Containerbereitstellungen die Ausgabe „standalone“ in Ihrer Next.js-Konfiguration [Inferenz]. Dadurch werden Abhängigkeiten automatisch verfolgt und nur die erforderlichen Dateien in einem kompakten Build-Ordner gebündelt. Dies reduziert die Größe des Container-Images und beschleunigt den Containerstart [Inferenz].

Next.js-App erstellen und bereitstellen

Sie können Ihre Next.js-Anwendung mit zwei primären Workflows erstellen und starten: Rapid AI Prototyping (keine lokale CLI-Einrichtung erforderlich) oder Standard Container Deployment (für benutzerdefinierte Codebasen).

Pfad A: Schnelles Prototyping mit dem AI Studio-Build-Modus und der Starter-Stufe

Für Rapid Prototyping und Vibe-Coding-Workflows können Entwickler im Build-Modus von Google AI Studio Full-Stack-Next.js-Anwendungen in natürlicher Sprache beschreiben und direkt in Cloud Run veröffentlichen, ohne Befehlszeilentools verwalten oder ein Rechnungskonto konfigurieren zu müssen.

Schritt 1: App im Build-Modus initialisieren

  1. Rufen Sie Google AI Studio auf und wechseln Sie in den Build-Modus.
  2. Geben Sie einen Prompt ein, der die Benutzeroberfläche, das Styling und die Geschäftslogik beschreibt (z. B. „Erstelle einen kollaborativen Projekt-Tracker in Next.js mit interaktiven Task-Boards und Nutzeranmeldung“).
  3. Der integrierte KI-Agent generiert die Next.js-Komponentendateien, konfiguriert App Router-Layouts, installiert npm-Abhängigkeiten und zeigt eine interaktive Live-Vorschau direkt in Ihrem Browser an.

Schritt 2: Integrierten Datenbankspeicher und Nutzeranmeldung hinzufügen

  • Persistente Daten: Wenn Ihr Prompt Datenspeicher erfordert, aktivieren Sie Cloud Firestore oder Cloud SQL for PostgreSQL (Developer Edition). Der KI-Agent entwirft automatisch Ihre Datenmodelle, Clientverbindungsdateien und Sicherheitsregeln.
  • Nutzerauthentifizierung: Aktivieren Sie die Firebase-Authentifizierung, um Google Log-in-Abläufe zu aktivieren, ohne benutzerdefinierte OAuth-Weiterleitungs-Handler schreiben zu müssen.

Schritt 3: In Cloud Run veröffentlichen

  1. Klicken Sie oben auf der Benutzeroberfläche auf Veröffentlichen > Erste Schritte > App veröffentlichen.
  2. Geben Sie Ihre benutzerdefinierte URL <my-nextjs-app>.ai.studio an und bestätigen Sie die Bereitstellungsregion.
  3. Die Plattform verpackt Ihren Container, stellt die zugrunde liegende Rechenleistung bereit und liefert Ihnen innerhalb von Sekunden eine Live-HTTPS-Produktions-URL (*.run.app).

Pfad B: Benutzerdefinierte Next.js-Codebasis in Cloud Run bereitstellen

Für vorhandene Codebasen oder Projekte, die aus Tools wie Claude Code, Replit oder lokalen Entwicklungsumgebungen exportiert wurden, containerisieren Sie Ihre Anwendung und stellen Sie sie mit der Google Cloud CLI bereit.

Schritt 1: Eigenständige Ausgabe konfigurieren

Aktualisieren Sie die Datei „next.config.js“ (oder „next.config.mjs“), um einen eigenständigen Build zu erstellen [Inferenz]:

  • JavaScript
Wird geladen...

Schritt 2: Mehrstufiges Dockerfile erstellen

Erstellen Sie im Stammordner eine .dockerignore-Datei mit node_modules und .env, damit lokale Entwicklungsdateien nicht in Ihren Container eingebunden werden.

Erstellen Sie ein Dockerfile im Stammverzeichnis Ihres Projekts:

  • Dockerfile
Wird geladen...

Schritt 3: In Cloud Run bereitstellen

Stellen Sie direkt aus Ihrem Projektordner mit der Google Cloud CLI bereit und weisen Sie eine leicht zu merkende und freizugebende benutzerdefinierte URL im Format <my-cool-app>.cloud.run zu:

  • Bash
Wird geladen...

Preisgestaltung für die kostenlose Stufe und die Starter-Stufe

Wenn Sie wissen, wie kostenlose Kontingente funktionieren, können Sie Ihre Next.js-Anwendung zuverlässig prototypisieren und skalieren:

Wahltaste

Computing- und Ressourcenkontingente

Anforderungen und Limits

• Cloud Run: Bis zu 2 aktive Webanwendungen

• Cloud Firestore: 1 GiB Speicher, 50.000 Lesevorgänge/Tag, 40.000 Schreibvorgänge/Tag

• Cloud SQL: PostgreSQL Developer Edition (Skalierung auf null)

• Firebase Authentication: Google Log-in enthalten

• Gültiges Google-Konto

• Weder Kreditkarte noch Rechnungskonto erforderlich

• Ressourcen, die an eine einzelne Region gebunden sind

• Cloud Run: 2 Millionen Anfragen/Monat, 180.000 vCPU-Sekunden/Monat, 360.000 GiB-Sekunden/Monat, 1 GB ausgehender Netzwerktraffic/Monat in Nordamerika

• Startguthaben in Höhe von 300 $ für die ersten 90 Tage

• Verknüpftes Cloud-Rechnungskonto

• Vollständiger Zugriff auf die Plattform-API in allen Regionen

Wahltaste

Computing- und Ressourcenkontingente

Anforderungen und Limits

• Cloud Run: Bis zu 2 aktive Webanwendungen

• Cloud Firestore: 1 GiB Speicher, 50.000 Lesevorgänge/Tag, 40.000 Schreibvorgänge/Tag

• Cloud SQL: PostgreSQL Developer Edition (Skalierung auf null)

• Firebase Authentication: Google Log-in enthalten

• Gültiges Google-Konto

• Weder Kreditkarte noch Rechnungskonto erforderlich

• Ressourcen, die an eine einzelne Region gebunden sind

• Cloud Run: 2 Millionen Anfragen/Monat, 180.000 vCPU-Sekunden/Monat, 360.000 GiB-Sekunden/Monat, 1 GB ausgehender Netzwerktraffic/Monat in Nordamerika

• Startguthaben in Höhe von 300 $ für die ersten 90 Tage

• Verknüpftes Cloud-Rechnungskonto

• Vollständiger Zugriff auf die Plattform-API in allen Regionen

Best Practices für die Ausführung von Next.js in serverlosen Umgebungen

  • Eigenständige Ausgabe verwenden: Aktivieren Sie immer den eigenständigen Modus von Next.js, um zu vermeiden, dass nicht verwendete Entwicklungsabhängigkeiten in Ihre Produktionscontainer gepackt werden [Inferenz].
  • Instanzlimits für kostenpflichtige Projekte festlegen: Legen Sie beim Übergang von einer Prototyping-Sandbox zur Produktion „--max-instances“ fest (z. B. „--max-instances 5“), um sicherzustellen, dass unerwartete Traffic-Spitzen Ihr Budget nicht überschreiten.
  • React Server Components nutzen: Verlagern Sie die intensive Datenabfrage auf Serverkomponenten, um Ihr Browser-Bundle schlank zu halten und die Core Web Vitals zu verbessern [Inferenz].
  • Sicherstellen, dass Kunden-Umgebungsvariablen übernommen wurden: Beachten Sie, dass Umgebungsvariablen vom Typ NEXT_PUBLIC_ während des Build in Client-Bundles übernommen werden. Achten Sie darauf, dass sie definiert sind, bevor Sie die Build-Phase ausführen.

Meistern Sie Ihre geschäftlichen Herausforderungen mit Google Cloud

Neukunden erhalten ein Guthaben im Wert von 300 $ für Google Cloud.

Gleich loslegen

Profitieren Sie von einem Guthaben über 300 $, um Google Cloud und mehr als 20 „Immer kostenlos“ Produkte kennenzulernen.

Google Cloud