Bermigrasi ke Cloud Code for IntelliJ

Dokumen ini menjelaskan cara memigrasikan project App Engine berbasis IntelliJ ke Cloud Code for IntelliJ.

Perhatian: Mulai 31 Januari 2024, dukungan Java 8 untuk App Engine telah berakhir, dan akan dihentikan pada 31 Januari 2026. Akibatnya, Cloud Code menonaktifkan App Engine secara default. Untuk mengaktifkan App Engine di IDE Anda, buka Setelan > Google Cloud Code > App Engine. Karena penghentian penggunaan App Engine yang akan datang, sebaiknya jangan membuat project App Engine baru. Untuk mengetahui informasi selengkapnya tentang penghentian penggunaan App Engine, lihat artikel Penghentian penggunaan fitur. Untuk mengetahui informasi selengkapnya tentang jadwal dukungan runtime untuk App Engine, lihat Jadwal dukungan runtime.

Sebelum memulai

• Jika project Anda berbasis Maven atau Gradle dan menggunakan plugin berbasis App Engine SDK yang lebih lama (misalnya, com.google.appengine.appengine-maven-plugin dan com.google.appengine:gradle-appengine-plugin), Anda harus bermigrasi terlebih dahulu ke plugin Maven dan Gradle berbasis gcloud CLI yang baru.

• Plugin baru tidak mendukung peningkatan Datanucleus. Jika Anda bergantung pada fitur ini, Anda harus mengonfigurasi peningkatan Datanucleus (JDO, JPA) secara manual untuk project Anda agar dapat bermigrasi ke Cloud Code. Anda harus menggunakan Objectify sebagai lapisan ORM saat membaca/menulis ke Datastore.

Instal plugin baru

Jika Anda belum melakukannya, instal plugin dengan melakukan hal berikut:

• Pastikan Anda memiliki versi IDE yang didukung, JetBrains IDE versi 2022.3+ (seperti IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand), di PATH komputer Anda.
• Buka IntelliJ IDEA (atau JetBrains IDE yang didukung).
• Buka jendela marketplace plugin menggunakan File > Settings > Plugins. Untuk Mac OS X, gunakan IntelliJ IDEA > Preferences > Plugins.

• Telusuri plugin 'Cloud Code' dan instal.

  Anda mungkin diminta untuk memulai ulang IDE guna mengaktifkan plugin.

Mengonfigurasi IntelliJ dan project Anda

Setelah menginstal plugin, konfigurasi IntelliJ dan project Anda untuk menggunakan plugin baru sebagai berikut:

1. Saat diberi tahu bahwa plugin baru bertentangan dengan integrasi App Engine yang ada, klik link di perintah.

   

2. Pada perintah Nonaktifkan Plugin berikut, pilih 'Nonaktifkan dan Mulai Ulang' untuk menonaktifkan plugin App Engine dan memulai ulang IDE agar perubahan konfigurasi plugin diterapkan.

   

3. Saat diberi tahu bahwa project Anda dalam format lama, klik opsi untuk Konversi project Anda ke format baru.

4. Anda harus menghapus instance Server App Engine dan Cloud yang ada, lalu membuatnya ulang menggunakan gcloud CLI baru.

   1. Buka Settings > Build, Execution, Deployment > Application Servers.

   2. Pilih instance App Engine Dev Anda, lalu klik Hapus (-).

   3. Klik Add (+), lalu pilih Google App Engine Dev Server.

      

   4. Buka Settings > Build, Execution, Deployment > Clouds.

   5. Pilih instance cloud Google App Engine Anda, lalu klik Hapus (-).

   6. Klik Tambahkan (+) untuk mengonfigurasi target deployment cloud App Engine.

      

5. Jika Anda memiliki konfigurasi eksekusi server lokal App Engine, Anda harus memperbaruinya untuk menggunakan Server Aplikasi yang baru dikonfigurasi.

6. Buka Tools > Cloud Code > App Engine untuk melihat daftar tindakan yang tersedia bagi Anda untuk menjalankan dan men-deploy aplikasi, atau lihat dokumentasi untuk mengetahui informasi selengkapnya.

7. Untuk project berbasis Maven atau Gradle, pastikan Anda menggunakan plugin App Engine Gradle dan Maven versi terbaru.

Mengonfigurasi project khusus IntelliJ

Khusus untuk project spesifik IntelliJ (yaitu, project yang telah mengonfigurasi setelan project secara manual dengan aspek App Engine lama dan tidak disinkronkan dari Gradle atau Maven), update dependensi App Engine Anda.

Dependensi App Engine Anda masih dikonfigurasi sebagai 'External Libraries' dan disediakan oleh penginstalan SDK App Engine lama Anda. Jika Anda menghapus penginstalan App Engine SDK, aplikasi Anda tidak akan dikompilasi.

Untuk menghapus dependensi ini pada App Engine SDK lama, konfigurasikan dependensi App Engine API Anda menggunakan fitur impor library App Engine Facet sebagai berikut:

1. Pengguna fitur peningkatan Datanucleus JDO/JPA plugin lama harus mem-porting aplikasi mereka ke Maven atau Gradle karena peningkatan Datanucleus tidak didukung oleh plugin Cloud Code.

2. Dari UI Project Structure IntelliJ, buka tab dependensi modul App Engine Standard Anda.

3. Hapus semua library terkait App Engine.

   

4. Di UI Project Structure yang sama, buka aspek Google App Engine modul App Engine Anda.

5. Di panel Libraries, pilih dependensi App Engine yang Anda gunakan.

   

   Tindakan ini akan otomatis mengambil dependensi ini dari Maven Central dan menambahkannya ke classpath modul Anda.

6. Jalankan secara lokal dan deploy untuk memverifikasi bahwa konfigurasi baru Anda berfungsi.

7. Pada tahap ini, Anda dapat menghapus App Engine SDK lama dengan aman.

Mendapatkan dukungan

Untuk mengirimkan masukan atau melaporkan masalah di IDE IntelliJ, buka Tools > Cloud Code > Help / About > Submit feedback or report an issue untuk melaporkan masalah di GitHub.