Lorsque vous déployez une nouvelle application Next.js, Amplify utilise par défaut la version la plus récente prise en charge de Next.js. Actuellement, le fournisseur SSR de calcul Amplify Hosting prend en charge Next.js version 13.
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 de Next.js 12 ou version ultérieure. La console affiche une bannière d’informations identifiant les applications avec des branches qui sont 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 SSR de calcul 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 les branches Classic (Next.js 11 uniquement) et Next.js 12.
Utilisez les instructions suivantes pour migrer une application vers le fournisseur SSR de calcul Amplify Hosting.
Pour migrer une application vers le fournisseur SSR de calcul Amplify Hosting
Connectez-vous à AWS Management Console et ouvrez le Amplifier la console
. Choisissez l’application Next.js que vous souhaitez migrer.
Avant de migrer une application dans la console Amplify, vous devez d’abord mettre à jour le fichier package.json de l’application pour utiliser Next.js version 12 ou ultérieure.
Dans le volet de navigation, choisissez Paramètres de l’application,
Général.Sur la page d’accueil de l’application, la console affiche une bannière si l’application a des branches déployées à l’aide du Classique (Next.js 11 uniquement)
Fournisseur SSR. Sur la bannière, choisissez
Émigrer.Dans la fenêtre de confirmation de la migration, sélectionnez les trois déclarations et choisissez
Émigrer.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 pour l’application. Il existe trois valeurs de plate-forme valides. Une application SSG est définie sur la valeur de la plate-forme WEB
. Une application SSR utilisant Next.js version 11 est définie sur la valeur de la plate-forme WEB_DYNAMIC
. Une application SSR Next.js 12 ou ultérieure est définie sur la valeur de la plate-forme WEB_COMPUTE
.
Lorsque vous migrez une application en suivant les instructions de la section précédente, Amplify change la valeur de la plate-forme de votre application de WEB_DYNAMIC
à
WEB_COMPUTE
. Une fois la migration vers le calcul Amplify Hosting terminée, vous ne pouvez pas annuler la migration dans la console. Pour annuler la migration, vous devez utiliser l’interface de ligne de commande AWS pour redéfinir la plate-forme de l’application sur WEB_DYNAMIC
. Ouvrez une fenêtre de terminal et entrez la commande suivante, en mettant à jour le texte en rouge avec votre identifiant d’application unique et votre région.
aws amplify update-app --app-id abcd1234
--platform WEB_DYNAMIC --region us-west-2