I contenuti del file gradle.build sono un insieme di regole per descrivere la build. È scritto in un linguaggio specifico del dominio per descrivere le build, in base
al
linguaggio Groovy.
Ogni attività ha proprietà associate che puoi utilizzare. Puoi specificare
queste proprietà nel file gradle.build utilizzando una
chiusura di configurazione,
un'attività e delle proprietà.
In questo esempio:
La chiusura della configurazione per il plug-in è appengine.
L'attività è deploy.
Le proprietà stopPreviousVersion e promote sono impostate su true.
appengine{deploy{// deploy configurationstopPreviousVersion=true// default - stop the current versionpromote=true// default - & make this the current version}}
Se devi specificare solo alcune proprietà, puoi impostarle in una sola riga:
appengine.deploy.stopPreviousVersion=true
Consulta le sezioni seguenti per un elenco delle proprietà disponibili per
ogni attività.
appengineStage
task(stage)
Genera una directory dell'applicazione per il deployment. Utilizzato dall'attività appengineDeploy
e dall'attività jettyRun.
Puoi utilizzare le seguenti proprietà:
Proprietà
Descrizione
artifact
Artefatto creato contenente tutte le classi, le risorse e i manifest.
Il valore predefinito è build/libs/[YOUR_SERVLET].war.
appEngineDirectory
Posizione del file app.yaml. Il valore predefinito è
src/main/appengine.
dockerDirectory
Posizione di Dockerfile. Il valore predefinito è
src/main/docker.
stagingDirectory
Obbligatorio. La directory in cui eseguire lo staging dell'applicazione. Il valore predefinito è
build/staged-app.
appengineDeploy
task(deploy)
Organizza e distribuisce un'applicazione in App Engine.
Ogni attività ha proprietà associate che puoi utilizzare. Puoi specificare
queste proprietà nel file gradle.build utilizzando una
chiusura di configurazione,
un'attività e delle proprietà.
Nel seguente esempio:
La chiusura della configurazione per il plug-in è appengine.
L'attività è run.
La proprietà port è impostata su 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}}
Se devi specificare solo alcune proprietà, puoi impostarle in una sola riga:
appengine.run.port=8888
Proprietà
Descrizione
appEngineDirectory
Posizione dei file di configurazione .yaml (cron, index ecc.) da cui verranno eseguiti i deployment specifici della configurazione (appengineDeployCron ecc.). Per le applicazioni flessibili, il valore predefinito è
src/main/appengine.
bucket
Il bucket Cloud Storage utilizzato per eseguire il provisioning dei file associati al
deployment. Se questo argomento non viene specificato, viene utilizzato il bucket predefinito
dell'applicazione.
deployables
I file YAML per i servizi o le configurazioni di cui vuoi eseguire il deployment.
Il valore predefinito è il file app.yaml nella directory di staging. Se
non viene trovato, tenta di generare automaticamente i file di configurazione necessari (ad esempio app.yaml) nella directory di staging.
imageUrl
Esegui il deployment con un'immagine Docker specifica. L'URL Docker deve provenire da uno dei
nomi host Artifact Registry validi.
project
Il nome del progetto Google Cloud da utilizzare per questa chiamata.
Il valore predefinito è il progetto attuale selezionato durante
l'inizializzazione dello strumento gcloud. Per eseguire la verifica,
utilizza gcloud config list project.
promote
Promuovi la versione di cui è stato eseguito il deployment per ricevere tutto il traffico. Il valore predefinito è True.
server
Il server App Engine a cui connettersi. In genere, non è necessario modificare
questo valore.
stopPreviousVersion
Arresta la versione in esecuzione in precedenza quando esegui il deployment di una nuova versione che
riceve tutto il traffico.
version
La versione dell'app che verrà creata o sostituita da questo
deployment. Se non specifichi una versione, ne verrà generata una per
te.
Proprietà globali
Proprietà
Descrizione
tools.cloudSdkHome
Proprietà facoltativa per configurare la posizione di Google Cloud CLI.
In genere, il plug-in lo trova in gcloud CLI quando viene installato con
gcloud components install app-engine-java.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 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-----------------"]]
