Migrando um aplicativo SSR 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 13.

O console do Amplify detecta aplicações em sua conta que foram implantadas antes do lançamento do serviço de computação Amplify Hosting totalmente compatível com Next.js 12 e 13. 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. Uma aplicação não pode conter as ramificações Classic (somente Next.js 11) e Next.js 12 ou 13.

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 no AWS Management Console e abra o console do Amplify.

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

   nota

   Antes de migrar uma aplicação no console do Amplify, primeiro você deve atualizar o arquivo package.json do aplicação para usar o Next.js versão 12 ou 13.

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 aplicação de SSR Next.js 12 ou 13 é definida 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