Attività e proprietà del plug-in Gradle App Engine

Dopo aver aggiunto il plug-in Gradle per App Engine al tuo progetto, puoi utilizzare le seguenti attività Gradle specifiche di App Engine nella tua app Java 8:

Attività	Descrizione
tasks	Visualizza le informazioni della guida sulle attività installate.
appengineStage	Genera una directory dell'applicazione per il deployment.
appengineDeploy	Organizza e distribuisce un'applicazione in App Engine.
appengineDeployCron	Esegue il deployment di un file di configurazione cron.yaml in App Engine.
appengineDeployDispatch	Esegue il deployment di un file di configurazione dispatch.yaml in App Engine.
appengineDeployDos	Esegue il deployment di un file di configurazione dos.yaml in App Engine.
appengineDeployIndex	Esegue il deployment di un file di configurazione index.yaml in App Engine.
appengineDeployQueue	Esegue il deployment di un file di configurazione queue.yaml in App Engine.
jettyRun	Esegue il server di sviluppo utilizzando le configurazioni predefinite di Jetty. Per scoprire di più sul plug-in Gretty, vedi Configurazione di Gretty e Attività di Gretty.

Per visualizzare un elenco di tutte le attività:

gradle tasks

Per maggiori informazioni su come configurare e utilizzare Gradle, consulta Utilizzo di App Engine Gradle e il repository app-gradle-plugin su GitHub.

Proprietà dell'attività

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à.

L'esempio seguente mostra come specificare le attività Gradle per Java 8. Per Java versione 11 e successive, consulta la sezione Runtime Java per saperne di più sull'utilizzo delle versioni più recenti.

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 configuration
    stopPreviousVersion = true  // default - stop the current version
    promote = 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 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
  }
}

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.