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.7.0</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 Container Registry yang valid, misalnya, `gcr.io/foo`, dengan `foo` adalah nama gambar.	`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`