Migración de una aplicación Next.js 1.1 a Amplify Hosting Compute

Al implementar una nueva aplicación de Next.js, Amplify utiliza de forma predeterminada la versión compatible más reciente de Next.js. Actualmente, el proveedor de SSR de cómputo Amplify Hosting admite la versión 14 de Next.js.

La consola Amplify detecta las aplicaciones de su cuenta que se implementaron antes del lanzamiento del servicio de cómputo Amplify Hosting y es totalmente compatible con las versiones 12, 13 y 14 de Next.js. La consola muestra un banner informativo que identifica las aplicaciones con ramificaciones que se han implementado con el anterior proveedor clásico de SSR de Amplify (solo Next.js 11). Se recomienda que migre sus aplicaciones al proveedor SSR de procesamiento de Amplify Hosting.

Debe migrar manualmente la aplicación y todas sus ramificaciones de producción al mismo tiempo. Una aplicación no puede contener las ramas Classic (solo Next.js 11) y Next.js 12, 13 o 14.

Siga las siguientes instrucciones para migrar una aplicación al proveedor SSR de procesamiento de Amplify Hosting.

Para migrar una aplicación al proveedor de SSR de procesamiento de Amplify Hosting

1. Inicia sesión en la consola de Amplify AWS Management Console y ábrela.

2. Elija la aplicación Next.js que desea migrar.

   nota

   Antes de migrar una aplicación a la consola de Amplify, primero debes actualizar el archivo package.json de la aplicación para usar la versión 12, 13 o 14 de Next.js.

3. En el panel de navegación, elija Configuración de la aplicación y General.

4. En la página de inicio de la aplicación, la consola muestra un banner si la aplicación tiene ramificaciones implementadas con el proveedor SSR clásico (solo para Next.js 11). En el banner, elija Migrar.

5. En la ventana de confirmación de migración, elija las tres sentencias y elija Migrar.

6. Amplify compilará y volverá a implementar su aplicación para completar la migración.

Reversión de una migración de SSR

Al implementar una aplicación de Next.js, Amplify Hosting detecta la configuración de la aplicación y establece el valor de la plataforma interna de la aplicación. Existen tres valores de plataforma válidos. Una aplicación SSG se configura en el valor de la plataforma WEB. Una aplicación SSR que utilice la versión 11 de Next.js se configura en el valor de la plataforma WEB_DYNAMIC. Una aplicación SSR de Next.js 12 o posterior se configura en el valor de la plataforma WEB_COMPUTE.

Al migrar una aplicación siguiendo las instrucciones de la sección anterior, Amplify cambia el valor de la plataforma de la aplicación de WEB_DYNAMIC a WEB_COMPUTE. Una vez completada la migración al procesamiento de Amplify Hosting, no puede revertir la migración en la consola. Para revertir la migración, debe utilizar AWS Command Line Interface para cambiar la plataforma de la aplicación a WEB_DYNAMIC. Abra una ventana de terminal e introduzca el siguiente comando para actualizar el ID y la región de la aplicación con su información exclusiva.

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