Migrieren einer Next.js 11-App auf Amplify Hosting Compute

Wenn Sie eine neue Next.js App bereitstellen, verwendet Amplify standardmäßig die neueste unterstützte Version von Next.js. Derzeit unterstützt der Compute SSR-Anbieter Amplify Hosting Next.js Version 14.

Die Amplify-Konsole erkennt Apps in Ihrem Konto, die vor der Veröffentlichung des Amplify Hosting-Rechendienstes mit voller Unterstützung für die Versionen 12, 13 und 14 von Next.js bereitgestellt wurden. Auf der Konsole wird ein Informationsbanner angezeigt, das Apps mit Filialen identifiziert, die über den vorherigen SSR-Anbieter von Amplify, Classic, bereitgestellt wurden (nur Next.js 11). Wir empfehlen dringend, dass Sie Ihre Apps zum Amplify Hosting-Compute-SSR-Anbieter migrieren.

Sie müssen die App und alle ihre Produktionszweige gleichzeitig manuell migrieren. Eine App kann nicht sowohl Classic (nur Next.js 11) als auch Next.js 12, 13 oder 14 Branches enthalten.

Verwenden Sie die folgenden Anweisungen, um eine App zum Amplify Hosting-Compute-SSR-Anbieter zu migrieren.

Um eine App zum Amplify Hosting-Compute-SSR-Anbieter zu migrieren

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

2. Wählen Sie die App Next.js aus, die Sie migrieren möchten.

   Anmerkung

   Bevor Sie eine App in der Amplify-Konsole migrieren, müssen Sie zunächst die package.json-Datei der App aktualisieren, um Next.js Version 12, 13 oder 14 zu verwenden.

3. Wählen Sie im Navigationsbereich App-Einstellungen, Allgemein aus.

4. Auf der Startseite der App zeigt die Konsole ein Banner an, wenn die App über Zweige verfügt, die über den SSR-Anbieter Classic (nur Next.js 11) bereitgestellt wurden. Wählen Sie auf dem Banner Migrieren aus.

5. Wählen Sie im Bestätigungsfenster für die Migration die drei Anweisungen aus und wählen Sie Migrieren aus.

6. Amplify erstellt Ihre App und stellt sie erneut bereit, um die Migration abzuschließen.

Eine SSR-Migration rückgängig machen

Wenn Sie eine Next.js App bereitstellen, erkennt Amplify Hosting die Einstellungen in Ihrer App und legt den internen Plattformwert für die App fest. Es gibt drei gültige Plattformwerte. Eine SSG-App ist auf den Plattformwert WEB eingestellt. Eine SSR-App, die Next.js Version 11 verwendet, ist auf den Plattformwert gesetzt. WEB_DYNAMIC Eine SSR-App Next.js 12 oder höher ist auf den Plattformwert eingestellt. WEB_COMPUTE

Wenn Sie eine App mithilfe der Anweisungen im vorherigen Abschnitt migrieren, ändert Amplify den Plattformwert Ihrer App von WEB_DYNAMIC aufWEB_COMPUTE. Nachdem die Migration zu Amplify Hosting Compute abgeschlossen ist, können Sie die Migration in der Konsole nicht mehr rückgängig machen. Um die Migration rückgängig zu machen, müssen Sie den verwenden, AWS Command Line Interface um die Plattform der App wieder zu ändern. WEB_DYNAMIC Öffnen Sie ein Terminalfenster und geben Sie den folgenden Befehl ein, um die App-ID und die Region mit Ihren eindeutigen Informationen zu aktualisieren.

aws amplify update-app --app-id abcd1234 --platform WEB_DYNAMIC --region us-west-2