Menjalankan dan men-debug aplikasi App Engine Standard secara lokal di 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 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 Tools > Cloud Code > App Engine Run on a local App Engine Standard dev server.

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. Pada dialog, klik Server Lokal Standar Google App Engine.

3. Setelah project di-build, Anda dapat menetapkan titik henti sementara untuk men-debug aplikasi.

Men-debug aplikasi secara lokal di Edisi Komunitas

IntelliJ Community Edition tidak menyediakan dukungan bawaan untuk menjalankan aplikasi lokal berbasis servlet Java. Untuk men-debug aplikasi secara lokal menggunakan IntelliJ Community Edition, konfigurasikan project Anda untuk 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. Membuat konfigurasi Run/Debug untuk Maven.

   

   1. Pilih Run > Edit Configurations.

   2. Klik + Tambahkan Konfigurasi Baru.

   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 + Tambahkan Konfigurasi Baru.

   3. Pilih Remote.

   4. Pastikan nomor port sama dengan port yang Anda konfigurasikan dalam 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 secara lokal:

   1. Pilih Run > Debug.

   2. Pilih konfigurasi proses debug jarak jauh Anda.

      

      Sekarang Anda 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. Membuat konfigurasi Run/Debug untuk Gradle.

   

   1. Pilih Run > Edit Configurations.

   2. Klik + Tambahkan Konfigurasi Baru.

   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 + Tambahkan Konfigurasi Baru.

   3. Pilih Remote.

   4. Pastikan nomor port sama dengan port yang Anda konfigurasi dalam konfigurasi plugin App Engine Gradle. 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 secara lokal:

   1. Pilih Run > Debug.

   2. Pilih konfigurasi proses debug jarak jauh Anda.

      

      Sekarang Anda 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, konfigurasikan nomor port yang berbeda (misalnya, 5009) dalam konfigurasi plugin App Engine Gradle dan perbarui nomor port dalam konfigurasi jarak jauh ke nomor port yang sama.

Langkah selanjutnya

• 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.