Bereitstellung serverseitig gerenderter Apps mit Amplify Hosting

Sie können Folgendes verwenden … AWS Amplify um Web-Apps bereitzustellen und zu hosten, die serverseitiges Rendern (SSR) verwenden. Amplify Hosting erkennt automatisch Anwendungen, die mit dem Framework Next.js erstellt wurden, und Sie müssen keine manuelle Konfiguration in der AWS Management Console.

Amplify unterstützt auch jedes Javascript-basierte SSR Framework mit einem Open-Source-Build-Adapter, der die Build-Ausgabe einer Anwendung in die Verzeichnisstruktur umwandelt, die Amplify Hosting erwartet. Sie können beispielsweise Apps bereitstellen, die mit Nuxt, Astro und den SvelteKit Frameworks erstellt wurden, indem Sie die verfügbaren Adapter installieren.

Fortgeschrittene Benutzer können die Bereitstellungsspezifikation verwenden, um einen Build-Adapter zu erstellen oder ein Post-Build-Skript zu konfigurieren.

Sie können die folgenden Frameworks mit minimaler Konfiguration für Amplify Hosting bereitstellen.

Next.js

• Amplify unterstützt Next.js 14-Anwendungen, ohne dass ein Adapter erforderlich ist. Um zu beginnen, sehen Sie sich Amplify Sie die Unterstützung für Next.js an.

Nuxt.js

• Amplify unterstützt Anwendungsbereitstellungen von Nuxt.js mit einem voreingestellten Adapter. Um zu beginnen, sehen Sie sich Amplify Sie die Unterstützung für Nuxt.js an.

Astro.js

• Amplify unterstützt Anwendungsbereitstellungen von Astro.js mit einem Community-Adapter. Um zu beginnen, sehen Sie sich Amplify Sie die Unterstützung für Astro.js an.

SvelteKit

• Amplify unterstützt SvelteKit Anwendungsbereitstellungen mit einem Community-Adapter. Um zu beginnen, sehen Sie sich Amplify Sie die Unterstützung für SvelteKit an.

Open-Source-Adapter

• Verwenden Sie einen Open-Source-Adapter — Anweisungen zur Verwendung von Adaptern, die nicht in der obigen Liste aufgeführt sind, finden Sie unterVerwendung von Open-Source-Adaptern.

• Erstellen Sie einen Framework-Adapter — Framework-Autoren, die Funktionen integrieren möchten, die ein Framework bietet, können die Amplify Hosting-Bereitstellungsspezifikation verwenden, um Ihre Build-Ausgabe so zu konfigurieren, dass sie der von Amplify erwarteten Struktur entspricht. Weitere Informationen finden Sie unter Verwenden der Amplify Hosting-Bereitstellungsspezifikation zur Konfiguration der Build-Ausgabe.

• Konfigurieren Sie ein Post-Build-Skript — Sie können die Amplify Hosting-Bereitstellungsspezifikation verwenden, um Ihre Build-Ausgabe nach Bedarf für bestimmte Szenarien zu bearbeiten. Weitere Informationen finden Sie unter Verwenden der Amplify Hosting-Bereitstellungsspezifikation zur Konfiguration der Build-Ausgabe. Ein Beispiel finden Sie unter Bereitstellen eines Express-Servers mithilfe des Deployment-Manifests.

Themen

• Amplify Sie die Unterstützung für Next.js
• Amplify Sie die Unterstützung für Nuxt.js
• Amplify Sie die Unterstützung für Astro.js
• Amplify Sie die Unterstützung für SvelteKit
• Stellen Sie eine SSR App für Amplify bereit
• SSRunterstützte Funktionen
• Preise für Apps SSR
• Problembehandlung bei SSR Bereitstellungen
• Fortgeschritten: Open-Source-Adapter

Stellen Sie eine SSR App für Amplify bereit

Sie können diese Anweisungen verwenden, um eine App bereitzustellen, die mit einem beliebigen Framework erstellt wurde, mit einem Bereitstellungspaket, das der von Amplify erwarteten Build-Ausgabe entspricht. Wenn Sie eine Next.js -Anwendung bereitstellen, ist kein Adapter erforderlich.

Wenn Sie eine SSR App bereitstellen, die einen Framework-Adapter verwendet, müssen Sie zuerst den Adapter installieren und konfigurieren. Detaillierte Anweisungen finden Sie unter Verwendung von Open-Source-Adaptern.

Um eine SSR App für Amplify Hosting bereitzustellen

1. Melden Sie sich bei der an AWS Management Console und öffne die Amplify-Konsole.

2. Wählen Sie auf der Seite Alle Apps die Option Neue App erstellen.

3. Wählen Sie auf der Seite Start building with Amplify Ihren Git-Repository-Anbieter aus und klicken Sie dann auf Weiter.

4. Gehen Sie auf der Seite Repository-Zweig hinzufügen wie folgt vor:

   1. Wählen Sie den Namen des Repositorys aus, zu dem Sie eine Verbindung herstellen möchten.

   2. Wählen Sie den Namen des Repository-Zweigs aus, zu dem eine Verbindung hergestellt werden soll.

   3. Wählen Sie Weiter.

5. Auf der Seite mit den App-Einstellungen erkennt Amplify automatisch SSR Apps von Next.js.

   Wenn Sie eine SSR App bereitstellen, die einen Adapter für ein anderes Framework verwendet, müssen Sie Amazon CloudWatch Logs explizit aktivieren. Öffnen Sie den Abschnitt Erweiterte Einstellungen und wählen Sie dann im Abschnitt Serverseitiges Rendering (SSR) Deployment die Option SSRApp-Logs aktivieren aus.

6. Für die App ist eine IAM Servicerolle erforderlich, die Amplify übernimmt, um Protokolle an Ihre AWS-Konto.

   Das Verfahren zum Hinzufügen einer Servicerolle hängt davon ab, ob Sie eine neue Rolle erstellen oder eine bestehende verwenden möchten.

   • Um eine neue Rolle zu erstellen:

     1. Wählen Sie Neue Servicerolle erstellen und verwenden aus.

   • Um eine bestehende Rolle zu verwenden:

     1. Wählen Sie Eine bestehende Rolle verwenden aus.

     2. Wählen Sie in der Liste der Servicerollen die zu verwendende Rolle aus.

7. Wählen Sie Weiter.

8. Wählen Sie auf der Seite Überprüfen die Option Speichern und bereitstellen aus.