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

Dopo aver aggiunto il plug-in Gradle di App Engine al progetto, puoi utilizzare le seguenti attività Gradle specifiche di App Engine:

Attività Descrizione
tasks Visualizza le informazioni della guida sulle attività installate.
appengineStage Genera una directory dell'applicazione per il deployment.
appengineDeploy Prepara ed esegue il deployment di 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, consulta Configurazione di Gretty e Attività di Gretty

Per visualizzare un elenco di tutte le attività:

gradle tasks

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

Proprietà delle 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, basato sul linguaggio Groovy.

Di seguito sono riportate le proprietà associate a ogni attività che puoi utilizzare. Puoi specificare queste proprietà nel file gradle.build utilizzando una chiusura di configurazione, un'attività e le proprietà.

In questo esempio:

  • La chiusura di 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 singola riga:

  appengine.deploy.stopPreviousVersion = true

Nelle sezioni seguenti è riportato un elenco delle proprietà disponibili per ogni attività.

appengineStage

task(stage)

Genera una directory dell'applicazione per il deployment. Utilizzata dalle attività appengineDeploy e jettyRun.

Puoi utilizzare le seguenti proprietà:

Proprietà Descrizione
artifact Artefatto creato che contiene tutte le classi, le risorse e i manifesti. Il valore predefinito è build/libs/[YOUR_SERVLET].war.
appEngineDirectory Percorso del file app.yaml. Il valore predefinito è src/main/appengine.
dockerDirectory Percorso del Dockerfile. Il valore predefinito è src/main/docker.
stagingDirectory Obbligatorio. La directory in cui preparare l'applicazione. Il valore predefinito è build/staged-app.

appengineDeploy

task(deploy)

Prepara ed esegue il deployment di un'applicazione in App Engine.

Di seguito sono riportate le proprietà associate a ogni attività che puoi utilizzare. Puoi specificare queste proprietà nel file gradle.build utilizzando una chiusura di configurazione, un'attività e le proprietà.

Nel seguente esempio:

  • La chiusura di 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 singola riga:

  appengine.run.port = 8888
Proprietà Descrizione
appEngineDirectory Percorso dei file di configurazione .yaml (cron, index e così via) da cui verranno eseguiti i deployment specifici della configurazione (appengineDeployCron e così via). Per le applicazioni flessibili, il valore predefinito è src/main/appengine.
bucket Il bucket Cloud Storage utilizzato per preparare i 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 preparazione. Se non viene trovato, tenta di generare automaticamente i file di configurazione necessari (ad esempio app.yaml) nella directory di preparazione.
imageUrl Esegui il deployment con un'immagine Docker specifica. L'URL Docker deve provenire da uno dei validi nomi host di Artifact Registry.
project Il nome del progetto della piattaforma Google Cloud da utilizzare per questa chiamata. Il valore predefinito è il progetto attuale selezionato durante l'inizializzazione dello strumento gcloud. Per verificare, 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 precedente 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.