Sasaran dan Parameter Plugin Maven App Engine

Setelah menambahkan plugin App Engine Maven berbasis gcloud CLI ke project Anda , sasaran Maven khusus App Engine berikut akan tersedia:

Tujuan Deskripsi
appengine:cloudSdkLogin Menetapkan status gcloud CLI global untuk account.
appengine:deploy Melakukan tahapan dan men-deploy aplikasi ke App Engine.
appengine:deployAll Melakukan tahapan dan men-deploy aplikasi dengan semua konfigurasi yaml yang valid secara bersamaan ke App Engine.
appengine:deployCron Melakukan tahapan dan men-deploy file konfigurasi cron.yaml ke App Engine.
appengine:deployDispatch Melakukan tahapan dan men-deploy file konfigurasi dispatch.yaml ke App Engine.
appengine:deployDos Melakukan tahapan dan men-deploy file konfigurasi dos.yaml ke App Engine.
appengine:deployIndex Melakukan tahapan dan men-deploy file konfigurasi index.yaml ke App Engine.
appengine:deployQueue Melakukan tahapan dan men-deploy file konfigurasi queue.yaml ke App Engine.
appengine:help Menampilkan informasi bantuan tentang plugin Maven App Engine.
appengine:run Menjalankan server pengembangan App Engine. Saat berjalan, server terus memeriksa untuk menentukan apakah appengine-web.xml telah berubah. Jika ya, server akan memuat ulang aplikasi. Anda tidak perlu menghentikan dan memulai ulang aplikasi karena adanya perubahan pada appengine-web.xml. Sasaran ini didukung untuk layanan paket lama.
appengine:stage Menghasilkan direktori aplikasi untuk deployment.
appengine:start Mulai menjalankan devserver App Engine secara asinkron, lalu kembali ke command line. Saat sasaran ini berjalan, perilakunya sama dengan sasaran run, kecuali bahwa Maven terus memproses sasaran dan keluar setelah server aktif dan berjalan. Sasaran ini didukung untuk layanan paket lama.
appengine:stop Menghentikan server pengembangan web App Engine yang sedang berjalan. Sasaran ini didukung untuk layanan paket lama.

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan dan menggunakan Maven, lihat Menggunakan Maven.

Menggunakan parameter

Setiap sasaran memiliki parameter terkait yang dapat Anda tentukan di file pom.xml. Contoh:

<plugins>
   <plugin>
     <groupId>com.google.cloud.tools</groupId>
     <artifactId>appengine-maven-plugin</artifactId>
     <version>2.8.1</version>
     <configuration>
       <deploy.stopPreviousVersion>true</deploy.stopPreviousVersion>
       <cloudSdkHome>/usr/foo/path/to/cloudsdk</cloudSdkHome>
     </configuration>
  </plugin>
</plugins>

Anda juga dapat menentukan parameter konfigurasi dalam command line, dengan mengikuti pola -D[USER_PROPERTY]=[PARAMETER_VALUE].

Misalnya, untuk menetapkan direktori tempat melakukan tahapan aplikasi:

mvn appengine:stage -Dapp.stage.stagingDirectory=[YOUR_STAGING_DIRECTORY]

Lihat bagian berikut untuk mengetahui daftar parameter yang tersedia untuk setiap sasaran.

appengine:deploy

Melakukan tahapan dan men-deploy aplikasi ke App Engine.

Anda dapat menggunakan parameter berikut, beberapa di antaranya sesuai dengan tanda command line gcloud app deploy atau tanda command line gcloud app services:

Parameter Deskripsi Properti Pengguna
appEngineDirectory Direktori yang berisi app.yaml dan file konfigurasi App Engine lain yang didukung. Default-nya adalah ${basedir}/src/main/appengine. app.stage.appEngineDirectory
artifact Lokasi arsip JAR atau WAR yang akan di-deploy. Default-nya adalah ${project.build.directory}/${project.build.finalName}.${project.packaging}. app.stage.artifact
bucket Bucket Cloud Storage yang digunakan untuk melakukan tahapan file yang terkait dengan deployment. Jika argumen ini tidak ditentukan, bucket default aplikasi akan digunakan. app.deploy.bucket
cloudSdkPath Parameter opsional untuk mengonfigurasi lokasi Google Cloud CLI. Default-nya adalah menemukan secara otomatis dari PATH atau lokasi instal standar. cloudSdkPath
deployables File YAML untuk layanan atau konfigurasi yang ingin Anda deploy. Defaultnya adalah file app.yaml dalam direktori staging. Jika tidak ditemukan, coba buat secara otomatis file konfigurasi yang diperlukan (seperti app.yaml) di direktori staging. app.deploy.deployables
dockerDirectory Direktori yang berisi Dockerfile dan resource Docker lainnya. Default-nya adalah ${basedir}/src/main/docker/. app.stage.dockerDirectory
imageUrl Men-deploy dengan image Docker tertentu. ImageUrl harus berupa nama Artifact Registry yang valid, misalnya, docker.pkg.dev/foo, dengan foo adalah nama image. app.deploy.imageUrl
projectId Nama project Google Cloud yang akan digunakan untuk pemanggilan ini. Defaultnya adalah project saat ini yang dipilih saat melakukan inisialisasi gcloud. app.deploy.projectId
promote Mempromosikan versi yang di-deploy untuk menerima semua traffic. Default-nya adalah True. app.deploy.promote
server Server App Engine yang akan dihubungkan. Biasanya, Anda tidak perlu mengubah nilai ini. app.deploy.server
stagingDirectory Wajib. Direktori tempat aplikasi dijalankan. Default-nya adalah ${project.build.directory}/appengine-staging. app.stage.stagingDirectory
stopPreviousVersion Hentikan versi yang berjalan sebelumnya saat men-deploy versi baru yang menerima semua traffic. app.deploy.stopPreviousVersion
version Versi aplikasi yang akan dibuat atau diganti oleh deployment ini. Jika Anda tidak menentukan versi, versi tersebut akan dibuat untuk Anda. app.deploy.version

appengine:help

Menampilkan informasi bantuan tentang plugin Maven App Engine. Untuk menampilkan detail parameter, panggil:

mvn appengine:help -Ddetail=true -Dgoal=[GOAL_NAME]

Anda dapat menggunakan parameter berikut:

Parameter Deskripsi Properti Pengguna
detail Jika benar, tampilkan semua properti yang dapat ditetapkan untuk setiap sasaran. Default-nya adalah False. detail
goal Nama tujuan untuk menampilkan bantuan. Jika tidak ditentukan, semua sasaran akan ditampilkan. goal
indentSize Jumlah spasi per tingkat indentasi. Harus berupa angka positif. Default-nya adalah 2. indentSize
lineLength Panjang maksimum baris tampilan. Harus berupa angka positif. Default-nya adalah 80. lineLength

appengine:stage

Menghasilkan direktori build aplikasi untuk deployment.

Anda dapat menggunakan parameter berikut:

Parameter Deskripsi Properti Pengguna
appEngineDirectory Direktori yang berisi app.yaml dan file konfigurasi App Engine lain yang didukung. Default-nya adalah ${basedir}/src/main/appengine. app.stage.appEngineDirectory
artifact Lokasi arsip JAR atau WAR yang akan di-deploy. Default-nya adalah ${project.build.directory}/${project.build.finalName}.${project.packaging}. app.stage.artifact
cloudSdkPath Parameter opsional untuk mengonfigurasi lokasi gcloud CLI. cloudSdkPath
dockerDirectory Direktori yang berisi Dockerfile dan resource Docker lainnya. Default-nya adalah ${basedir}/src/main/docker/${basedir}/src/main/docker/. app.stage.dockerDirectory
stagingDirectory Wajib. Direktori tempat aplikasi dijalankan. Default-nya adalah ${project.build.directory}/appengine-staging app.stage.stagingDirectory