Menggunakan Apache Maven dan App Engine Plugin

Apache Maven adalah alat otomatisasi build untuk Java.

App Engine menyediakan plugin Maven yang dapat Anda gunakan untuk mem-build dan men-deploy aplikasi ke App Engine. Plugin ini tidak mendukung project Enterprise Application Archive (EAR).

Sebelum memulai

  1. Tentukan apakah Maven sudah diinstal dan versi mana yang Anda miliki dengan menjalankan perintah berikut:

    mvn -v

    Jika Maven sudah diinstal, string informasi panjang yang diawali dengan Apache Maven dan diikuti dengan nomor versi seperti 3.9.1 akan ditampilkan.

  2. Jika Anda belum menginstal Maven 3.9.1 atau yang lebih baru:

    1. Download Maven 3.9.1 atau yang lebih baru.
    2. Instal Maven 3.9.1 atau yang lebih baru.

  3. Jika belum melakukannya, ikuti langkah-langkah di sini untuk mendownload gcloud CLI, membuat project Google Cloud, dan menginisialisasi aplikasi App Engine Anda.

  4. Instal komponen app-engine-java gcloud CLI:

    gcloud components install app-engine-java

Menambahkan plugin Maven App Engine

Untuk menggunakan plugin Maven App Engine, tambahkan baris berikut ke bagian plugins dalam file pom.xml project Anda:

<plugins>
   <plugin>
     <groupId>com.google.cloud.tools</groupId>
     <artifactId>appengine-maven-plugin</artifactId>
     <version>2.8.1</version>
   </plugin>
   <plugin>
     <groupId>org.eclipse.jetty</groupId>
     <artifactId>jetty-maven-plugin</artifactId>
     <version>9.4.56.v20240826</version>
   </plugin>
</plugins>
 Plugin App Engine menyertakan plugin Jetty Maven, yang dapat Anda gunakan untuk menguji aplikasi dengan cepat tanpa membuat file WAR.

Menggunakan plugin Jetty Maven untuk menguji aplikasi secara lokal

Selama fase pengembangan, Anda dapat menjalankan dan menguji aplikasi kapan saja di server pengembangan dengan memanggil plugin Jetty Maven.

Untuk menjalankan aplikasi Anda di server pengembangan:

  1. Bangun aplikasi jika Anda belum melakukannya:

    mvn package

  2. Ubah direktori ke level teratas project Anda (misalnya, ke myapp), dan jalankan aplikasi Anda dengan memanggil Maven:

    mvn jetty:run

  3. Tunggu hingga server dimulai dan gunakan browser Anda untuk membuka http://localhost:8080/ guna mengakses aplikasi.

  4. Matikan aplikasi dan server pengembangan dengan menekan Control+C.

Membangun dan men-deploy aplikasi

Setelah menambahkan plugin Maven App Engine ke file pom.xml project, Anda dapat menggunakan perintah berikut untuk mem-build dan men-deploy aplikasi:

mvn package appengine:deploy -Dapp.deploy.projectId=PROJECT_ID

Ganti PROJECT_ID dengan ID project Google Cloud Anda. Jika file pom.xml sudah menentukan project ID, Anda tidak perlu menyertakan properti -Dapp.deploy.projectId dalam perintah yang dijalankan singkat ini.

Sasaran package membangun dan mengemas aplikasi Anda, dan sasaran appengine:deploy melakukan hal berikut:

  1. Menghasilkan ID versi yang unik untuk versi baru aplikasi Anda.

  2. Men-deploy versi baru ke App Engine.

  3. Merutekan semua traffic ke versi baru.

Mengubah setelan default deployment

Anda dapat mengubah perilaku deployment default dengan meneruskan parameter dalam perintah appengine:deploy. Misalnya, perintah berikut men-deploy layanan yang ditentukan dalam file pom.xml ke project Google Cloud tertentu, menetapkan ID versi kustom ke layanan, dan menonaktifkan perutean traffic otomatis untuk versi baru:

mvn appengine:deploy -Dapp.deploy.projectId=PROJECT_ID -Dapp.deploy.version=VERSION_ID -Dapp.deploy.promote=False

Anda juga dapat menggunakan perintah appengine:deploy untuk men-deploy file konfigurasi, seperti cron.yaml, dispatch.yaml, dan index.yaml.

Untuk informasi selengkapnya, lihat appengine:deployreferensi.

Langkah selanjutnya