Migrando um aplicativo Next.js 11 para a computação do Amplify Hosting

Quando você implanta um novo aplicativo Next.js, por padrão, o Amplify usa a versão mais recente compatível do Next.js. Atualmente, o provedor SSR de computação Amplify Hosting oferece suporte ao Next.js versão 14.

O console do Amplify detecta aplicativos em sua conta que foram implantados antes do lançamento do serviço de computação Amplify Hosting com suporte total para as versões 12, 13 e 14 do Next.js. O console exibe um banner de informações identificando aplicativos com ramificações que são implantadas usando o provedor SSR anterior do Amplify, o Classic (somente Next.js 11). É altamente recomendável que você migre seus aplicativos para o provedor de SSR de computação do Amplify Hosting.

Você deve migrar manualmente o aplicativo e todas as suas ramificações de produção ao mesmo tempo. Um aplicativo não pode conter as ramificações Classic (somente Next.js 11) e Next.js 12, 13 ou 14.

Use as instruções a seguir para migrar um aplicativo para o provedor de SSR de computação do Amplify Hosting.

Para migrar um aplicativo para o provedor de SSR de computação do Amplify Hosting

1. Faça login AWS Management Console e abra o console do Amplify.

2. Escolha o aplicativo Next.js que você deseja migrar.

   nota

   Antes de migrar um aplicativo no console do Amplify, você deve primeiro atualizar o arquivo package.json do aplicativo para usar as versões 12, 13 ou 14 do Next.js.

3. No painel de navegação, em Configurações do aplicativo, selecione Geral.

4. Na página inicial do aplicativo, o console exibirá um banner se o aplicativo tiver ramificações implantadas usando o provedor SSR Classic (somente Next.js 11). No banner, escolha Migrar.

5. Na janela de confirmação da migração, selecione as três instruções e escolha Migrar.

6. O Amplify criará e reimplantará seu aplicativo para concluir a migração.

Revertendo uma migração de SSR

Quando você implanta um aplicativo Next.js, o Amplify Hosting detecta as configurações em seu aplicativo e define o valor interno da plataforma para o aplicativo. Há três valores válidos de plataforma. Um aplicativo SSG é definido com o valor WEB da plataforma. Um aplicativo SSR usando o Next.js versão 11 é definido com o valor WEB_DYNAMIC da plataforma. Um aplicativo SSR Next.js 12 ou posterior é definido com o valor WEB_COMPUTE da plataforma.

Quando você migra um aplicativo usando as instruções na seção anterior, o Amplify altera o valor da plataforma do seu aplicativo de WEB_DYNAMIC para WEB_COMPUTE. Após a conclusão da migração para a computação do Amplify Hosting, você não pode reverter a migração no console. Para reverter a migração, você deve usar o AWS Command Line Interface para alterar a plataforma do aplicativo de volta para o WEB_DYNAMIC. Abra uma janela do terminal e digite o comando a seguir, atualizando o ID do aplicativo e a região com suas informações exclusivas.

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