Gradle adalah alat otomatisasi build open source yang berfokus pada fleksibilitas dan performa. App Engine menyediakan plugin Gradle yang dapat Anda gunakan untuk membangun dan men-deploy aplikasi ke App Engine.
Contoh kode menunjukkan cara mengonfigurasi filebuild.gradle
untuk menambahkan tugas Gradle App Engine, repositori Maven, plugin Gradle App Engine, dan dependensi untuk Java 8.
Untuk Java versi 11 dan yang lebih baru, lihat runtime Java
untuk mengetahui informasi selengkapnya tentang penggunaan versi yang lebih baru.
Sebelum memulai
Instal Gradle (v3.4.1 atau yang lebih baru)
Jika belum melakukannya, ikuti langkah-langkah dalam panduan ini untuk mendownload gcloud CLI, membuat project Google Cloud, dan menginisialisasi aplikasi App Engine Anda.
Instal komponen
app-engine-java
gcloud CLI:gcloud components install app-engine-java
Membuat project Gradle baru
Anda dapat membuat project Gradle baru dari awal menggunakan shell. Atau, untuk mencoba plugin, Anda dapat mendownload, menjalankan secara lokal, dan men-deploy project halo dunia.
Untuk membuat project baru:
Buat direktori baru dan buka direktori tersebut.
Untuk melakukan inisialisasi project baru:
Jalankan
gradle init
:gradle init --type java-library
Buat folder
WEB-INF
:mkdir -p src/main/webapp/WEB-INF
Buat folder
appengine
:mkdir -p src/main/appengine
Hapus file stub yang dihasilkan oleh
gradle init
:rm src/main/java/Library.java src/test/java/LibraryTest.java
Tambahkan kode berikut ke file
build.gradle
Anda untuk menambahkan tugas Gradle App Engine, repositori Maven, plugin Gradle App Engine, dependensi, dan konfigurasi tugas:Anda juga perlu menambahkan file berikut ke project menggunakan editor teks atau Integrated Development Environment (IDE):
src/main/appengine/app.yaml
src/main/webapp/WEB-INF/web.xml
(kecuali jika aplikasi Anda menggunakan anotasi Servlet 3.1)- src/main/docker/Dockerfile (opsional untuk runtime kustom)
- Class Java
- Class pengujian Java
Baca artikel Menyiapkan lingkungan pengembangan Anda untuk melihat ringkasan project Java App Engine.
Men-download aplikasi Halo Dunia
Clone repositori aplikasi contoh Halo Dunia ke komputer lokal Anda:
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
Anda juga dapat mendownload contoh sebagai file ZIP dan mengekstraknya.
Ubah ke direktori yang berisi kode contoh:
cd java-docs-samples/flexible/java-8/helloworld
Menguji aplikasi dengan server pengembangan
Untuk mengakses resource Google dari project Anda saat berjalan secara lokal, tetapkan kredensial default aplikasi dengan menjalankan:
gcloud auth application-default login
Ubah ke root direktori aplikasi Anda.
Selama fase pengembangan, Anda dapat menjalankan dan menguji aplikasi kapan saja di server pengembangan dengan memanggil Gradle:
gradle jettyRun
Anda juga dapat menjalankan Gradle tanpa menginstalnya dengan menggunakan wrapper Gradle.
Tunggu hingga server dimulai. Server akan dimulai dengan aplikasi berjalan saat Anda melihat pesan yang mirip dengan ini:
:prepareInplaceWebAppFolder :createInplaceWebAppFolder :compileJava :processResources UP-TO-DATE :classes :prepareInplaceWebAppClasses :prepareInplaceWebApp :jettyRun 17:40:05 INFO Jetty 9.2.15.v20160210 started and listening on port 8080 17:40:05 INFO runs at: 17:40:05 INFO http://localhost:8080/
Lihat aplikasi Anda berjalan di
http://localhost:8080
.
Untuk mempelajari plugin Gretty lebih lanjut, lihat Konfigurasi Gretty dan Tugas Gretty.
Men-deploy aplikasi Anda
Untuk men-deploy aplikasi Anda:
gradle appengineDeploy
Tugas appengineDeploy
dan semua tugas Gradle lainnya memiliki properti terkait
yang dapat Anda gunakan. Untuk mengetahui daftar lengkap tugas dan properti, lihat Tugas dan Properti Gradle App Engine.
Menggunakan wrapper Gradle
Gradle menyediakan mekanisme untuk mendownload dan menjalankan versi Gradle yang diperlukan tanpa penginstalan:
Linux/macOS
Ubah ke direktori kode contoh.
Jalankan gradlew:
./gradlew jettyRun
Windows
Ubah ke direktori kode contoh.
Jalankan gradlew:
./gradlew.bat jettyRun
Informasi tambahan tentang Gradle dapat ditemukan di Tugas dan Properti Gradle App Engine.
Langkah selanjutnya
- Pelajari kode plugin dan laporkan masalah di GitHub.
- Pelajari cara menentukan properti untuk tugas dengan membaca Tugas dan Properti Gradle App Engine.