Tugas dan Properti Plugin App Engine Gradle

Setelah plugin Gradle App Engine ditambahkan ke project Anda, Anda dapat menggunakan tugas Gradle khusus App Engine berikut di aplikasi Java 8:
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.

Contoh berikut menunjukkan cara menentukan tugas Gradle untuk Java 8. Untuk Java versi 11 dan yang lebih baru, lihat runtime Java untuk mengetahui informasi selengkapnya tentang penggunaan versi yang lebih baru.

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 yang akan ditentukan, Anda dapat menempatkannya 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 yang akan ditentukan, Anda dapat menempatkannya 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 Artifact 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.