Menjalankan dan men-debug aplikasi App Engine Standard secara lokal di 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 men-deploy aplikasi ke App Engine, Anda dapat menjalankan dan men-debug aplikasi standar App Engine secara lokal. Dokumen ini menjelaskan cara mengonfigurasi IDE untuk menjalankan dan men-debug secara lokal dari dalam IntelliJ IDEA.

Catatan: IDE berikut mendukung fitur ini:

• IntelliJ IDEA - Ultimate
• IntelliJ IDEA - Komunitas

Catatan: Untuk lingkungan standar App Engine, hanya aplikasi Java yang menggunakan runtime Java 8 yang didukung di Cloud Code.

Sebelum memulai

• Pastikan aplikasi Anda adalah project standar App Engine yang berisi file appengine-web.xml

• Untuk mengakses Library Klien Cloud secara lokal, selesaikan prosedur Menambahkan Library Klien Cloud ke Project Maven Anda.

Catatan: Konfigurasi run untuk run dan debug lokal hanya tersedia di IntelliJ Ultimate Edition. Jika menggunakan Community Edition, Anda dapat mengikuti petunjuk men-debug aplikasi secara lokal di Community Edition untuk menggunakan plugin Maven atau Gradle untuk menjalankan aplikasi secara lokal.

Menjalankan aplikasi secara lokal

Jika menggunakan IntelliJ IDEA Ultimate Edition, Anda dapat menjalankan aplikasi App Engine secara lokal dengan mengikuti petunjuk berikut:

1. Pilih File > Open untuk membuka project yang ingin Anda jalankan.

2. Buka direktori yang berisi project Anda.

3. Pilih Alat > Cloud Code > App Engine Jalankan di server dev App Engine Standard lokal.

Project memerlukan waktu beberapa saat untuk di-build.

Mengedit konfigurasi run

Mengonfigurasi server

Anda dapat mengedit konfigurasi run untuk server lokal:

1. Pilih Run > Edit Configurations.

2. Dari dialog Run/Debug Configurations, perbarui setelan konfigurasi sesuai kebutuhan. Beberapa setelan umum meliputi:

   • Artefak yang akan di-deploy.
   • Host App Engine.
   • Port App Engine.

Menambahkan variabel lingkungan

Jika perlu, tambahkan variabel lingkungan ke konfigurasi Anda.

1. Pilih tab Startup/Connection.

2. Pilih Run.

3. Centang kotak Pass environment variables.

4. Tambahkan variabel yang diperlukan.

5. Pilih Debug.

6. Centang kotak Pass environment variables.

7. Tambahkan variabel yang diperlukan.

   

8. Setelah selesai, klik Oke.

Menghentikan server

Untuk menghentikan Server Aplikasi Dev, pilih Run > Stop 'Google App Engine Standard Local Server'.

Men-debug aplikasi

Anda dapat menggunakan konfigurasi run yang dibuat sebelumnya untuk menjalankan aplikasi dalam mode debug sebagai berikut:

1. Pilih Run > Debug.

2. Dalam dialog, klik Google App Engine Standard Local Server.

3. Setelah project dibuat, Anda dapat menyetel titik henti sementara untuk men-debug aplikasi.

Men-debug aplikasi Anda secara lokal di Community Edition

IntelliJ Community Edition tidak menyediakan dukungan bawaan untuk menjalankan aplikasi berbasis servlet Java lokal. Untuk men-debug aplikasi secara lokal menggunakan IntelliJ Community Edition, konfigurasikan project Anda agar menggunakan plugin Maven atau Gradle.

Maven

Mengonfigurasi project menggunakan plugin Maven

1. Tambahkan plugin Maven App Engine ke file pom.xml project Anda.

2. Mengonfigurasi proses debug di server pengembangan.

3. Buat konfigurasi Run/Debug untuk Maven.

   

   1. Pilih Run > Edit Configurations.

   2. Klik + Add New Configuration.

   3. Pilih Maven.

   4. Di kolom Command line, masukkan appengine:run.

   5. Klik Oke.

4. Buat konfigurasi debug jarak jauh.

   

   1. Pilih Run > Edit Configurations.

   2. Klik + Add New Configuration.

   3. Pilih Remote.

   4. Pastikan nomor port sama dengan port yang Anda konfigurasi di konfigurasi plugin Maven App Engine. Port 5005 adalah defaultnya.

   5. Di bagian Sebelum peluncuran, klik + Tambahkan.

   6. Pilih Run Another Configuration.

   7. Pilih konfigurasi run untuk project Maven Anda.

   8. Klik Oke.

5. Untuk men-debug aplikasi Anda secara lokal:

   1. Pilih Run > Debug.

   2. Pilih konfigurasi debug jarak jauh Anda.

      

      Anda kini dapat men-debug aplikasi secara lokal.

Gradle

Mengonfigurasi project menggunakan plugin Gradle

1. Buat project Gradle baru.

2. Mengonfigurasi proses debug di server pengembangan.

3. Buat konfigurasi Run/Debug untuk Gradle.

   

   1. Pilih Run > Edit Configurations.

   2. Klik + Add New Configuration.

   3. Pilih Gradle.

   4. Di kolom Gradle project, pilih modul tempat Anda mengonfigurasi plugin appengine-gradle-plugin.

   5. Di kolom Tasks, masukkan appengineRun.

   6. Klik Oke.

4. Buat konfigurasi debug jarak jauh.

   

   1. Pilih Run > Edit Configurations.

   2. Klik + Add New Configuration.

   3. Pilih Remote.

   4. Pastikan nomor port sama dengan port yang Anda konfigurasi di konfigurasi plugin Gradle App Engine. Port 5005 adalah defaultnya.

   5. Di bagian Sebelum peluncuran, klik + Tambahkan.

   6. Pilih Run Another Configuration.

   7. Pilih konfigurasi run untuk project Gradle Anda.

   8. Klik Oke.

5. Untuk men-debug aplikasi Anda secara lokal:

   1. Pilih Run > Debug.

   2. Pilih konfigurasi debug jarak jauh Anda.

      

      Anda kini dapat men-debug aplikasi secara lokal.

   3. Jika link Attach Debugger muncul di log konsol, klik link tersebut.

      Catatan: Jika port yang Anda pilih diblokir, konfigurasi nomor port lain (misalnya, 5009) di konfigurasi plugin Gradle App Engine dan perbarui nomor port di konfigurasi jarak jauh ke nomor port yang sama.

Langkah berikutnya

• Selanjutnya, Anda dapat men-deploy aplikasi ke lingkungan standar App Engine.

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.