Migrasi SSR aplikasi Next.js 11 ke komputasi Amplify Hosting - AWS Amplify Hosting

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Migrasi SSR aplikasi Next.js 11 ke komputasi Amplify Hosting

Saat Anda menerapkan aplikasi Next.js baru, secara default Amplify menggunakan versi Next.js terbaru yang didukung. Saat ini, SSR penyedia komputasi Amplify Hosting mendukung Next.js versi 14.

Konsol Amplify mendeteksi aplikasi di akun Anda yang digunakan sebelum rilis layanan komputasi Amplify Hosting dengan dukungan penuh untuk Next.js versi 12 hingga 15. Konsol menampilkan spanduk informasi yang mengidentifikasi aplikasi dengan cabang yang digunakan menggunakan SSR penyedia Amplify sebelumnya, Classic (hanya Next.js 11). Kami sangat menyarankan Anda memigrasikan aplikasi Anda ke penyedia komputasi Amplify HostingSSR.

Anda harus memigrasikan aplikasi secara manual dan semua cabang produksinya secara bersamaan. Aplikasi tidak dapat berisi cabang Classic (Next.js 11 saja) dan Next.js 12 atau yang lebih baru.

Gunakan petunjuk berikut untuk memigrasikan aplikasi ke penyedia komputasi Amplify HostingSSR.

Untuk memigrasikan aplikasi ke penyedia komputasi Amplify Hosting SSR
  1. Masuk ke AWS Management Console dan buka konsol Amplify.

  2. Pilih aplikasi Next.js yang ingin Anda migrasikan.

    catatan

    Sebelum memigrasikan aplikasi di konsol Amplify, Anda harus memperbarui file package.json aplikasi terlebih dahulu untuk menggunakan Next.js versi 12 atau yang lebih baru.

  3. Di panel navigasi, pilih Pengaturan aplikasi, Umum.

  4. Di beranda aplikasi, konsol menampilkan spanduk jika aplikasi memiliki cabang yang digunakan menggunakan SSRpenyedia Classic (hanya Next.js 11). Pada banner, pilih Migrate.

  5. Di jendela konfirmasi migrasi, pilih tiga pernyataan dan pilih Migrasi.

  6. Amplify akan membangun dan menerapkan ulang aplikasi Anda untuk menyelesaikan migrasi.

Mengembalikan migrasi SSR

Saat Anda menerapkan aplikasi Next.js, Amplify Hosting mendeteksi setelan di aplikasi Anda dan menetapkan nilai platform internal untuk aplikasi tersebut. Ada tiga nilai platform yang valid. SSGAplikasi diatur ke nilai platformWEB. SSRAplikasi yang menggunakan Next.js versi 11 disetel ke nilai platformWEB_DYNAMIC. SSRAplikasi Next.js 12 atau yang lebih baru disetel ke nilai platformWEB_COMPUTE.

Saat Anda memigrasikan aplikasi menggunakan petunjuk di bagian sebelumnya, Amplify mengubah nilai platform aplikasi WEB_DYNAMIC Anda dari ke. WEB_COMPUTE Setelah migrasi ke Amplify Hosting komputasi selesai, Anda tidak dapat mengembalikan migrasi di konsol. Untuk mengembalikan migrasi, Anda harus menggunakan file AWS Command Line Interface untuk mengubah platform aplikasi kembaliWEB_DYNAMIC. Buka jendela terminal dan masukkan perintah berikut, perbarui ID aplikasi dan Wilayah dengan informasi unik Anda.

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