Migration d'une application Next.js 11 vers Amplify Hosting Compute

Lorsque vous déployez une nouvelle application Next.js, Amplify utilise par défaut la dernière version prise en charge de Next.js. Actuellement, le fournisseur de SSR de calcul Amplify Hosting prend en charge la version 14 de Next.js.

La console Amplify détecte les applications de votre compte qui ont été déployées avant la sortie du service de calcul Amplify Hosting avec prise en charge complète des versions 12, 13 et 14 de Next.js. La console affiche une bannière d'information identifiant les applications dotées de branches déployées à l'aide de l'ancien fournisseur SSR d'Amplify, Classic (Next.js 11 uniquement). Nous vous recommandons vivement de migrer vos applications vers le fournisseur de calcul SSR d'Amplify Hosting.

Vous devez migrer manuellement l'application et toutes ses branches de production en même temps. Une application ne peut pas contenir à la fois des branches Classic (Next.js 11 uniquement) et Next.js 12, 13 ou 14.

Suivez les instructions suivantes pour migrer une application vers le fournisseur de calcul SSR d'Amplify Hosting.

Pour migrer une application vers le fournisseur de calcul SSR d'Amplify Hosting

1. Connectez-vous à la console Amplify AWS Management Console et ouvrez-la.

2. Choisissez l'application Next.js que vous souhaitez migrer.

   Note

   Avant de migrer une application dans la console Amplify, vous devez d'abord mettre à jour le fichier package.json de l'application pour utiliser les versions 12, 13 ou 14 de Next.js.

3. Dans le volet de navigation, choisissez Paramètres de l'application, Général.

4. Sur la page d'accueil de l'application, la console affiche une bannière si l'application possède des branches déployées à l'aide du fournisseur SSR Classic (Next.js 11 uniquement). Sur la bannière, choisissez Migrer.

5. Dans la fenêtre de confirmation de la migration, sélectionnez les trois instructions et choisissez Migrer.

6. Amplify créera et redéploiera votre application pour terminer la migration.

Annulation d'une migration SSR

Lorsque vous déployez une application Next.js, Amplify Hosting détecte les paramètres de votre application et définit la valeur de plate-forme interne de l'application. Il existe trois valeurs de plateforme valides. Une application SSG est définie sur la valeur WEB de la plateforme. Une application SSR utilisant Next.js version 11 est définie sur la valeur WEB_DYNAMIC de la plateforme. Une application SSR de Next.js 12 ou version ultérieure est définie sur la valeur WEB_COMPUTE de la plateforme.

Lorsque vous migrez une application en suivant les instructions de la section précédente, Amplify change la valeur de plateforme de votre application de àWEB_DYNAMIC. WEB_COMPUTE Une fois la migration vers Amplify Hosting terminée, vous ne pouvez pas annuler la migration dans la console. Pour annuler la migration, vous devez utiliser le AWS Command Line Interface pour redéfinir la plateforme de l'application. WEB_DYNAMIC Ouvrez une fenêtre de terminal et entrez la commande suivante pour mettre à jour l'ID de l'application et la région avec vos informations uniques.

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