Migrazione di un'app Next.js 11 al calcolo Amplify Hosting

Quando si distribuisce una nuova app Next.js, per impostazione predefinita Amplify utilizza la versione supportata più recente di Next.js. Attualmente, il provider SSR di calcolo Amplify Hosting supporta la versione 14 di Next.js.

La console Amplify rileva le app nel tuo account che sono state distribuite prima del rilascio del servizio di elaborazione Amplify Hosting con supporto completo per le versioni 12, 13 e 14 di Next.js. La console visualizza un banner informativo che identifica le app con filiali distribuite utilizzando il precedente provider SSR di Amplify, Classic (solo Next.js 11). Ti consigliamo vivamente di migrare le tue app al provider SSR di calcolo Amplify Hosting.

È necessario migrare manualmente l'app e tutte le sue filiali di produzione contemporaneamente. Un'app non può contenere sia i rami Classic (solo Next.js 11) che Next.js 12, 13 o 14.

Utilizza le seguenti istruzioni per migrare un'app al provider SSR di calcolo Amplify Hosting.

Per migrare un'app al provider SSR di calcolo Amplify Hosting

1. Accedi AWS Management Console e apri la console Amplify.

2. Scegli l'app Next.js che desideri migrare.

   Nota

   Prima di migrare un'app nella console Amplify, devi prima aggiornare il file package.json dell'app per utilizzare Next.js versione 12, 13 o 14.

3. Nel pannello di navigazione, scegli Impostazioni app, Generali.

4. Nella home page dell'app, la console visualizza un banner se l'app ha filiali distribuite utilizzando il provider SSR Classic (solo Next.js 11). Sul banner, scegli Migra.

5. Nella finestra di conferma della migrazione, seleziona le tre istruzioni e scegli Migra.

6. Amplify creerà e ridistribuirà la tua app per completare la migrazione.

Ripristino di una migrazione SSR

Quando distribuisci un'app Next.js, Amplify Hosting rileva le impostazioni nell'app e imposta il valore interno della piattaforma per l'app. Esistono tre valori di piattaforma validi. Un'app SSG è impostata sul valore WEB della piattaforma. Un'app SSR che utilizza Next.js versione 11 è impostata sul valore della piattaforma. WEB_DYNAMIC Un'app SSR Next.js 12 o successiva è impostata sul valore della piattaforma. WEB_COMPUTE

Quando esegui la migrazione di un'app utilizzando le istruzioni nella sezione precedente, Amplify modifica il valore della piattaforma della tua app da a. WEB_DYNAMIC WEB_COMPUTE Una volta completata la migrazione al calcolo di Amplify Hosting, non è possibile ripristinare la migrazione nella console. Per ripristinare la migrazione, è necessario utilizzare per ripristinare la piattaforma dell'app AWS Command Line Interface a. WEB_DYNAMIC Apri una finestra di terminale e inserisci il seguente comando, aggiornando l'ID dell'app e la regione con le tue informazioni uniche.

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