Migrasi 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, penyedia SSR 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, 13, dan 14. Konsol menampilkan spanduk informasi yang mengidentifikasi aplikasi dengan cabang yang digunakan menggunakan penyedia SSR Amplify sebelumnya, Classic (hanya Next.js 11). Kami sangat menyarankan Anda memigrasikan aplikasi Anda ke penyedia SSR komputasi Amplify Hosting.

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, 13, atau 14.

Gunakan petunjuk berikut untuk memigrasikan aplikasi ke penyedia SSR komputasi Amplify Hosting.

Untuk memigrasikan aplikasi ke penyedia SSR komputasi Amplify Hosting

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, 13, atau 14.

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

4. Di beranda aplikasi, konsol menampilkan spanduk jika aplikasi memiliki cabang yang digunakan menggunakan penyedia SSR Klasik (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. Aplikasi SSG diatur ke nilai WEB platform. Aplikasi SSR yang menggunakan Next.js versi 11 diatur ke nilai WEB_DYNAMIC platform. Aplikasi SSR Next.js 12 atau yang lebih baru disetel ke nilai WEB_COMPUTE platform.

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