Menjalankan dan men-debug aplikasi App Engine Standar secara lokal di Cloud Code untuk IntelliJ

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 dijalankan dan debug 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 Edisi Komunitas, Anda dapat mengikuti petunjuk men-debug aplikasi secara lokal di Edisi Komunitas guna menggunakan plugin Maven atau Gradle untuk operasi lokal Anda.

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

2. Cari direktori yang berisi project Anda.

3. Pilih Tools > Cloud Code > App Engine Run on a local App Engine Standard dev server.

Project membutuhkan waktu beberapa saat untuk dibangun.

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 mencakup:

   • Artefak untuk 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 OK.

Menghentikan server

Untuk menghentikan Server Aplikasi Dev, pilih Jalankan > Hentikan 'Server Lokal Standar Google App Engine'.

Men-debug aplikasi

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

1. Pilih Run > Debug.

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

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

Mendebug aplikasi Anda secara lokal di Edisi Komunitas

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

Maven

Mengonfigurasi project Anda menggunakan plugin Maven

1. Tambahkan plugin App Engine Maven 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 + Add New Configuration.

   3. Pilih Maven.

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

   5. Klik OK.

4. Membuat 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 OK.

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 Anda 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 + 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 OK.

4. Membuat 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 OK.

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, konfigurasikan nomor port lain (misalnya, 5009) di konfigurasi plugin Gradle App Engine 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.

Dapatkan dukungan

Untuk mengirimkan masukan atau melaporkan masalah di IntelliJ IDE, buka Alat > Cloud Code > Bantuan / Tentang > Kirim masukan atau laporkan masalah untuk melaporkan masalah di GitHub, atau ajukan pertanyaan di Stack Overflow.