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 configurationstopPreviousVersion=true// default - stop the current versionpromote=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 configurationrun{// local (dev_appserver) configuration (standard environments only)port=8080// default}deploy{// deploy configurationstopPreviousVersion=true// default - stop the current versionpromote=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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-19 UTC."],[[["\u003cp\u003eThe App Engine Gradle plugin provides various tasks for managing and deploying applications, including \u003ccode\u003eappengineStage\u003c/code\u003e, \u003ccode\u003eappengineDeploy\u003c/code\u003e, and others for deploying specific configuration files like \u003ccode\u003ecron.yaml\u003c/code\u003e, \u003ccode\u003edispatch.yaml\u003c/code\u003e, etc.\u003c/p\u003e\n"],["\u003cp\u003eEach task within the App Engine Gradle plugin has configurable properties, which can be set in the \u003ccode\u003egradle.build\u003c/code\u003e file using a configuration closure (e.g., \u003ccode\u003eappengine\u003c/code\u003e) or directly in a single line, like setting \u003ccode\u003eappengine.deploy.stopPreviousVersion = true\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eappengineStage\u003c/code\u003e task generates an application directory for deployment, with configurable properties such as \u003ccode\u003eartifact\u003c/code\u003e, \u003ccode\u003eappEngineDirectory\u003c/code\u003e, \u003ccode\u003edockerDirectory\u003c/code\u003e, and \u003ccode\u003estagingDirectory\u003c/code\u003e, with \u003ccode\u003ebuild/staged-app\u003c/code\u003e being the default for \u003ccode\u003estagingDirectory\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eappengineDeploy\u003c/code\u003e task stages and deploys applications to App Engine, and allows customization of the deployment through various properties, such as \u003ccode\u003epromote\u003c/code\u003e, \u003ccode\u003estopPreviousVersion\u003c/code\u003e, and \u003ccode\u003ebucket\u003c/code\u003e, which dictate the behavior of the deployment.\u003c/p\u003e\n"],["\u003cp\u003eYou can use \u003ccode\u003egradle tasks\u003c/code\u003e to see a complete list of all available tasks within the plugin.\u003c/p\u003e\n"]]],[],null,["# App Engine Gradle Plugin Tasks and Properties\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\nAfter the App Engine Gradle plugin is [added to your project](/appengine/docs/standard/java-gen2/using-gradle#creating_a_new_project),\nyou can use the following App Engine-specific Gradle tasks:\n\nTo see a list of all the tasks: \n\n gradle tasks\n\nFor more information on how to set up and use Gradle, see\n\n[Using\nApp Engine Gradle](/appengine/docs/standard/java-gen2/using-gradle)\nand the\n[`app-gradle-plugin`](https://github.com/GoogleCloudPlatform/app-gradle-plugin)\nrepository on GitHub.\n\nTask properties\n---------------\n\nThe contents of the `gradle.build` file are a set of rules to describe your\nbuild. It's written in a domain specific language for describing builds, based\non the\n[Groovy language](http://www.groovy-lang.org/).\n\nEach task has associated properties below that you can use. You can specify\nthese properties in the `gradle.build` file using a\n[configuration closure](https://docs.gradle.org/current/userguide/custom_plugins.html#sec:getting_input_from_the_build),\ntask, and properties.\n\nIn this example:\n\n- The configuration closure for the plugin is `appengine`.\n- The task is `deploy`.\n- The properties, `stopPreviousVersion` and `promote`, are set to `true`.\n\n appengine {\n deploy { // deploy configuration\n stopPreviousVersion = true // default - stop the current version\n promote = true // default - & make this the current version\n }\n }\n\nIf you only have a to specify a few properties, you can set them in a single line:\n\n\u003cbr /\u003e\n\n```java\n appengine.deploy.stopPreviousVersion = true\n```\n\nSee the following sections for a list of the properties that are available for\neach task.\n\nappengineStage\n--------------\n\n**task(stage)**\n\nGenerates an application directory for deployment. Used by the `appengineDeploy`\ntask and the `jettyRun` task.\n\nYou can use the following properties:\n\nappengineDeploy\n---------------\n\n**task(deploy)**\n\nStages and deploys an application to App Engine.\n\nEach task has associated properties below that you can use. You can specify\nthese properties in the `gradle.build` file using a\n[configuration closure](https://docs.gradle.org/current/userguide/custom_plugins.html#sec:getting_input_from_the_build),\ntask, and properties.\n\nIn the following example:\n\n- The configuration closure for the plugin is `appengine`.\n- The task is `run`.\n- The property, `port`, is set to `8080`.\n\n appengine { // App Engine tasks configuration\n run { // local (dev_appserver) configuration (standard environments only)\n port = 8080 // default\n }\n\n deploy { // deploy configuration\n stopPreviousVersion = true // default - stop the current version\n promote = true // default - & make this the current version\n }\n }\n\nIf you only have a to specify a few properties, you can set them in a single\nline: \n\n```java\n appengine.run.port = 8888\n```\n\nGlobal properties\n-----------------"]]
