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

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Migrando um SSR 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 SSR provedor 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 a 15 do Next.js. O console exibe um banner de informações identificando aplicativos com ramificações que são implantadas usando o SSR provedor anterior do Amplify, Classic (somente Next.js 11). É altamente recomendável que você migre seus aplicativos para o provedor de computação Amplify HostingSSR.

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 posterior.

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

Para migrar um aplicativo para o provedor de computação Amplify Hosting SSR
  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 um aplicativo no console do Amplify, você deve primeiro atualizar o arquivo package.json do aplicativo para usar o Next.js versão 12 ou posterior.

  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 Classic (somente Next.js 11)SSR. 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 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 SSG aplicativo é definido com o valor da plataformaWEB. Um SSR aplicativo usando a versão 11 do Next.js é definido com o valor da plataformaWEB_DYNAMIC. Um SSR aplicativo 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 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