將 Next.js 11 SSR 應用程式遷移至 Amplify Hosting 運算 - AWS Amplify 託管
還原SSR遷移

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

將 Next.js 11 SSR 應用程式遷移至 Amplify Hosting 運算

當您部署新的 Next.js 應用程式時，依預設，Amplify 會使用最新支援的 Next.js 版本。目前，Amplify 託管運算SSR供應商支援 Next.js 第 14 版。

Amplify 主控台會偵測在 Amplify Hosting 運算服務發行之前已部署在您帳戶中的應用程式，並完全支援 Next.js 第 12 版至第 15 版。主控台會顯示資訊橫幅，識別使用 Amplify 先前SSR提供者 Classic （僅限 Next.js 11） 部署的分支應用程式。我們強烈建議您將應用程式遷移至 Amplify Hosting 運算SSR提供者。

您必須同時手動遷移應用程式及其所有生產分支。應用程式不能同時包含 Classic （僅限 Next.js 11） 和 Next.js 12 或更新版本的分支。

使用下列指示將應用程式遷移至 Amplify Hosting 運算SSR提供者。

將應用程式遷移至 Amplify Hosting 運算SSR提供者

  1. 登入 AWS Management Console 並開啟 Amplify 主控台 。

  2. 選擇您要遷移的 Next.js 應用程式。

    注意

    在 Amplify 主控台中遷移應用程式之前，您必須先更新應用程式的 package.json 檔案以使用 Next.js 第 12 版或更新版本。

  3. 在導覽窗格中，選擇應用程式設定 、一般 。

  4. 在應用程式首頁上，如果應用程式使用 Classic （僅限 Next.js 11） SSR 供應商 部署分支，則主控台會顯示橫幅。在橫幅上，選擇遷移 。

  5. 在遷移確認視窗中，選取三個陳述式，然後選擇遷移 。

  6. Amplify 將建置並重新部署您的應用程式以完成遷移。

還原SSR遷移

部署 Next.js 應用程式時，Amplify Hosting 會偵測應用程式中的設定，並設定應用程式的內部平台值。有三個有效的平台值。SSG 應用程式會設定為平台值 WEB。使用 Next.js 第 11 版SSR的應用程式會設定為平台值 WEB_DYNAMIC。Next.js 12 或更新版本SSR的應用程式會設定為平台值 WEB_COMPUTE。

當您使用上一節中的指示遷移應用程式時，Amplify 會將應用程式的平台值從 變更為 WEB_DYNAMIC WEB_COMPUTE。遷移至 Amplify Hosting 運算完成後，您無法在主控台中還原遷移。若要還原遷移，您必須使用 AWS Command Line Interface 將應用程式的平台變更為 WEB_DYNAMIC。開啟終端機視窗並輸入下列命令，使用您唯一的資訊更新應用程式 ID 和區域。

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