Tugas dan Properti Plugin App Engine Gradle

Setelah plugin App Engine Gradle ditambahkan ke project Anda, Anda dapat menggunakan tugas Gradle khusus App Engine berikut:

Tugas	Deskripsi
`tasks`	Menampilkan informasi bantuan tentang tugas yang diinstal.
`appengineStage`	Menghasilkan direktori aplikasi untuk deployment.
`appengineDeploy`	Melakukan staging dan men-deploy aplikasi ke App Engine.
`appengineDeployCron`	Men-deploy file konfigurasi `cron.yaml` ke App Engine.
`appengineDeployDispatch`	Men-deploy file konfigurasi `dispatch.yaml` ke App Engine.
`appengineDeployDos`	Men-deploy file konfigurasi `dos.yaml` ke App Engine.
`appengineDeployIndex`	Men-deploy file konfigurasi `index.yaml` ke App Engine.
`appengineDeployQueue`	Men-deploy file konfigurasi `queue.yaml` ke App Engine.
`jettyRun`	Menjalankan server pengembangan menggunakan konfigurasi default Jetty. Untuk mengetahui informasi selengkapnya tentang plugin Gretty, lihat Gretty Configuration dan Gretty Tasks

Untuk melihat daftar semua tugas:

gradle tasks

Untuk informasi selengkapnya tentang cara menyiapkan dan menggunakan Gradle, lihat Menggunakan Gradle App Engine dan repositori app-gradle-plugin di GitHub.

Properti tugas

Konten file gradle.build adalah sekumpulan aturan untuk mendeskripsikan build Anda. Aturan ini ditulis dalam bahasa khusus domain untuk mendeskripsikan build, berdasarkan bahasa Groovy.

Setiap tugas memiliki properti terkait di bawah ini yang dapat Anda gunakan. Anda dapat menentukan properti ini dalam file gradle.build menggunakan penutupan konfigurasi, tugas, dan properti.

Dalam contoh ini:

Penutupan konfigurasi untuk plugin adalah appengine.
Tugasnya adalah deploy.
Properti stopPreviousVersion dan promote disetel ke true.

appengine {
  deploy {   // deploy configuration
    stopPreviousVersion = true  // default - stop the current version
    promote = true              // default - & make this the current version
  }
}

Jika hanya memiliki beberapa properti untuk menentukan, Anda dapat menyetelnya dalam satu baris:

  appengine.deploy.stopPreviousVersion = true

Lihat bagian berikut untuk mengetahui daftar properti yang tersedia untuk setiap tugas.

appengineStage

tugas(tahap)

Menghasilkan direktori aplikasi untuk deployment. Digunakan oleh tugas appengineDeploy dan tugas jettyRun.

Anda dapat menggunakan properti berikut:

Properti	Deskripsi
`artifact`	Artefak build yang berisi semua kelas, resource, dan manifes. Default-nya adalah `build/libs/[YOUR_SERVLET].war`.
`appEngineDirectory`	Lokasi file `app.yaml`. Default-nya adalah `src/main/appengine`.
`dockerDirectory`	Lokasi `Dockerfile`. Default-nya adalah `src/main/docker`.
`stagingDirectory`	Wajib. Direktori tempat melakukan staging aplikasi. Default-nya adalah `build/staged-app`.

appengineDeploy

task(deploy)

Melakukan staging dan men-deploy aplikasi ke App Engine.

Setiap tugas memiliki properti terkait di bawah ini yang dapat Anda gunakan. Anda dapat menentukan properti ini dalam file gradle.build menggunakan penutupan konfigurasi, tugas, dan properti.

Dalam contoh berikut:

Penutupan konfigurasi untuk plugin adalah appengine.
Tugasnya adalah run.
Properti port disetel ke 8080.

appengine {  // App Engine tasks configuration
  run {      // local (dev_appserver) configuration (standard environments only)
    port = 8080                 // default
  }

  deploy {   // deploy configuration
    stopPreviousVersion = true  // default - stop the current version
    promote = true              // default - & make this the current version
  }
}

Jika hanya memiliki beberapa properti untuk menentukan, Anda dapat menyetelnya dalam satu baris:

  appengine.run.port = 8888

Properti	Deskripsi
`appEngineDirectory`	Lokasi file konfigurasi `.yaml` (cron, index, dll.) tempat deployment tertentu konfigurasi (appengineDeployCron, dll.) akan di-deploy. Untuk aplikasi fleksibel, setelan defaultnya adalah `src/main/appengine`.
`bucket`	Bucket Cloud Storage digunakan untuk melakukan staging file yang terkait dengan deployment. Jika argumen ini tidak ditentukan, bucket default aplikasi akan digunakan.
`deployables`	File YAML untuk layanan atau konfigurasi yang ingin Anda deploy. Defaultnya adalah file `app.yaml` dalam direktori staging. Jika file tidak ditemukan, sistem akan mencoba untuk otomatis membuat file konfigurasi yang diperlukan (seperti `app.yaml`) dalam direktori staging.
`imageUrl`	Men-deploy dengan image Docker tertentu. URL Docker harus berasal dari salah satu nama host Google Container Registry yang valid.
`project`	Nama project Google Cloud Platform yang akan digunakan untuk pemanggilan ini. Default adalah project saat ini yang dipilih saat menginisialisasi alat gcloud. Untuk memverifikasi, gunakan `gcloud config list project`.
`promote`	Mempromosikan versi yang di-deploy untuk menerima semua traffic. Defaultnya adalah true.
`server`	Server App Engine yang akan dihubungkan. Biasanya, Anda tidak perlu mengubah nilai ini.
`stopPreviousVersion`	Hentikan versi yang berjalan sebelumnya saat men-deploy versi baru yang menerima semua traffic.
`version`	Versi aplikasi yang akan dibuat atau diganti oleh deployment ini. Jika Anda tidak menentukan versi, versi tersebut akan dibuat untuk Anda.

Properti global

Properti	Deskripsi
`tools.cloudSdkHome`	Properti opsional untuk mengonfigurasi lokasi Google Cloud CLI. Biasanya, plugin akan menemukannya di gcloud CLI saat diinstal dengan `gcloud components install app-engine-java`.