Bermigrasi ke Cloud Code for IntelliJ

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

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

Catatan: Hanya aplikasi Java yang didukung. Selain itu, untuk lingkungan standar App Engine, aplikasi Anda harus menggunakan runtime Java 8.

Sebelum memulai

• Jika project Anda berbasis Maven atau Gradle dan menggunakan plugin berbasis App Engine SDK 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 baru.

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

Menginstal 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 apa pun 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 untuk mengaktifkan plugin.

Mengonfigurasi IntelliJ dan project Anda

Setelah menginstal plugin, konfigurasikan 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 Mengonversi project ke format baru.

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

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

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

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

      

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

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

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

      

5. Jika memiliki konfigurasi server lokal App Engine yang berjalan, 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 khusus 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 'Library Eksternal' dan disediakan oleh penginstalan App Engine SDK lama Anda. Jika Anda menghapus penginstalan App EngineSDK, aplikasi Anda tidak akan dikompilasi.

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

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

2. Dari UI Struktur Project IntelliJ, buka tab dependensi modul Standar App Engine Anda.

3. Hapus semua library terkait App Engine.

   

4. Di UI Struktur Project yang sama, buka Google App Engine pada 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.