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 suportada do Next.js. Atualmente, o provedor de SSR computacional da Amplify Hosting suporta a versão 13 do Next.js.

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 o Next.js 12 ou posterior. O console exibe um banner informativo identificando aplicativos com filiais que são implantadas usando o provedor SSR anterior da Amplify, Classic (somente Next.js 11). É altamente recomendável migrar seus aplicativos para o provedor de SSR de computação da Amplify Hosting.

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

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

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

1. Faça login noAWS 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 a versão 12 ou posterior do Next.js.

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

4. Na página inicial do aplicativo, o console exibirá um banner se o aplicativo tiver filiais 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.

Reverter 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 de plataforma válidos. Um aplicativo SSG é definido de acordo com o valor da plataformaWEB. Um aplicativo SSR usando o Next.js versão 11 é definido com o valor da plataformaWEB_DYNAMIC. Um aplicativo SSR Next.js 12 ou posterior é definido com o valor da plataformaWEB_COMPUTE.

Quando você migra um aplicativo usando as instruções na seção anterior, o Amplify altera o valor da plataforma do seu aplicativo deWEB_DYNAMIC paraWEB_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 oAWS Command Line Interface para alterar novamente a plataforma do aplicativo paraWEB_DYNAMIC. Abra uma janela de terminal e digite o comando a seguir, atualizando o texto em vermelho com seu ID de aplicativo e região exclusivos.

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