Next.js 11 SSRアプリケーションを Amplify Hosting コンピューティングに移行する - AWS Amplify ホスティング

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Next.js 11 SSRアプリケーションを Amplify Hosting コンピューティングに移行する

新しい Next.js アプリをデプロイすると、デフォルトで Amplify はサポートされている最新バージョンの Next.js を使用します。現在、Amplify Hosting コンピューティングSSRプロバイダーは Next.js バージョン 14 をサポートしています。

Amplify コンソールは、Next.js バージョン 12~15 を完全にサポートしながら、Amplify Hosting コンピューティングサービスのリリース前にデプロイされたアカウント内のアプリケーションを検出します。コンソールには、Amplify の以前のSSRプロバイダーである Classic (Next.js 11 のみ) を使用してデプロイされたブランチを持つアプリケーションを識別する情報バナーが表示されます。Amplify Hosting コンピューティングSSRプロバイダーにアプリケーションを移行することを強くお勧めします。

アプリとそのすべての運用ブランチを同時に手動で移行する必要があります。アプリにはクラシック (Next.js 11 のみ) ブランチと Next.js 12 以降のブランチの両方を入れることはできません。

以下の手順に従って、アプリケーションを Amplify Hosting コンピューティングSSRプロバイダーに移行します。

アプリケーションを Amplify Hosting コンピューティングSSRプロバイダーに移行するには
  1. にサインイン AWS Management Console し、Amplify コンソール を開きます。

  2. 移行する Next.js アプリを選択します。

    注記

    Amplify コンソールでアプリを移行する前に、まず Next.js バージョン 12 以降を使用するようにアプリの package.json ファイルを更新する必要があります。

  3. ナビゲーションペインで [アプリの設定] の [一般] を選択します。

  4. アプリのホームページでは、アプリに Classic (Next.js 11 のみ) SSR プロバイダー を使用してブランチがデプロイされている場合、コンソールにバナーが表示されます。バナーで [移行] を選択します。

  5. 移行確認ウィンドウで3つのステートメントを選択し、[移行] を選択します。

  6. Amplify はアプリをビルドして再デプロイし、移行を完了します。

SSR 移行の取り消し

Next.js アプリをデプロイすると、Amplify ホスティングはアプリの設定を検出し、アプリの内部プラットフォーム値を設定します。有効なプラットフォーム値は3 つあります。SSG アプリケーションはプラットフォーム値 に設定されますWEB。Next.js バージョン 11 を使用するSSRアプリケーションは、プラットフォーム値 に設定されますWEB_DYNAMIC。Next.js 12 以降のSSRアプリケーションは、プラットフォーム値 に設定されますWEB_COMPUTE

前のセクションの手順を使用してアプリを移行すると、Amplify はアプリのプラットフォーム値をWEB_DYNAMICからWEB_COMPUTEに変更します。Amplify ホスティングコンピューティングへの移行が完了したら、コンソールで移行を元に戻すことはできません。移行を元に戻すには、 AWS Command Line Interface を使用してアプリのプラットフォームをWEB_DYNAMICに戻す必要があります。ターミナルウィンドウを開いて次のコマンドを入力し、アプリID とリージョンを独自の情報で更新します。

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