翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Next.js 11 SSRアプリを Amplify ホスティングコンピューティングに移行する
新しい Next.js アプリをデプロイすると、デフォルトで Amplify はサポートされている最新バージョンの Next.js を使用します。現在、Amplify ホスティングコンピューティングSSRプロバイダーは Next.js バージョン 15 をサポートしています。
Amplify コンソールは、2022 年 11 月の Amplify ホスティングコンピューティングサービスのリリース前にデプロイされたアカウント内のアプリを検出し、Next.js バージョン 12 から 15 を完全にサポートします。コンソールには、Amplify の以前のSSRプロバイダーである Classic (Next.js 11 のみ) を使用してデプロイされたブランチを持つアプリを識別する情報バナーが表示されます。アプリを Amplify ホスティングコンピューティングSSRプロバイダーに移行することを強くお勧めします。
ホストされている Next.js 11 アプリケーションを Next.js 12 以降に更新する場合、デプロイがトリガーされると"target" property is no longer supported
エラーが発生することがあります。この場合、Amplify ホスティングコンピューティングに移行する必要があります。
アプリとそのすべての運用ブランチを同時に手動で移行する必要があります。アプリにはクラシック (Next.js 11 のみ) ブランチと Next.js 12 以降のブランチの両方を入れることはできません。
以下の手順に従って、アプリケーションを Amplify ホスティングコンピューティングSSRプロバイダーに移行します。
アプリを Amplify ホスティングコンピューティングSSRプロバイダーに移行するには
-
にサインイン AWS Management Console し、Amplify コンソール
を開きます。 -
移行する Next.js アプリを選択します。
注記
Amplify コンソールでアプリを移行する前に、まず Next.js バージョン 12 以降を使用するようにアプリの package.json ファイルを更新する必要があります。
-
ナビゲーションペインで [アプリの設定] の [一般] を選択します。
-
アプリのホームページに、 Classic (Next.js 11 のみ) SSRプロバイダーを使用してデプロイされたブランチがある場合、コンソールにバナーが表示されます。バナーで [移行] を選択します。
-
移行確認ウィンドウで3つのステートメントを選択し、[移行] を選択します。
-
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 --regionus-west-2