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

Dopo aver aggiunto App Engine per tuo progetto, puoi utilizzare i seguenti livelli di Gradle specifici per App Engine per applicazioni nell'ambiente standard di App Engine:

Attività	Descrizione
`tasks`	Mostra le informazioni della guida sulle attività installate.
`appengineCloudSdkLogin`	Imposta lo stato globale della gcloud CLI per account.
`appengineDeploy`	Organizza in fasi ed esegue il deployment di un'applicazione in App Engine.
`appengineDeployAll`	Mette in fase ed esegue il deployment di un'applicazione con tutti i suoi file YAML validi configurazioni contemporaneamente ad App Engine.
`appengineDeployCron`	Mette in fase ed esegue il deployment di una configurazione `cron.yaml` in App Engine.
`appengineDeployDispatch`	Mette in fase ed esegue il deployment di una configurazione `dispatch.yaml` in App Engine.
`appengineDeployDos`	Mette in fase ed esegue il deployment di una configurazione `dos.yaml` in App Engine.
`appengineDeployIndex`	Mette in fase ed esegue il deployment di una configurazione `index.yaml` in App Engine.
`appengineDeployQueue`	Mette in fase ed esegue il deployment di una configurazione `queue.yaml` in App Engine.
`appengineRun`	Esegue il server di sviluppo di App Engine. Quando il server è in esecuzione, verifica continuamente se `appengine-web.xml` è cambiato. In caso affermativo, il server si ricarica. per l'applicazione. Non è necessario arrestare e riavviare l'applicazione a causa di modifiche a `appengine-web.xml`.
`appengineStage`	Genera una directory dell'applicazione per il deployment.
`appengineStart`	Avvia l'esecuzione del server di sviluppo App Engine in modo asincrono e poi torna alla riga di comando. Quando l'obiettivo viene eseguito, il comportamento uguale all'obiettivo di esecuzione, tranne che Gradle continua a elaborare le attività. quando il server è attivo e in esecuzione.
`appengineStop`	Arresta un server di sviluppo web di App Engine in esecuzione.
`explodeWar`	Esplode il file WAR nella directory di compilazione.

Per visualizzare un elenco di tutte le attività:

gradle tasks

Per saperne di più su come configurare e utilizzare Gradle, vedi Utilizzo di App Engine Gradle.

Proprietà attività

I contenuti del file gradle.build sono un insieme di regole per descrivere la tua build. È scritte in un linguaggio specifico per il dominio, per descrivere le build, in base Linguaggio volgare.

A ogni attività sono associate delle seguenti proprietà che puoi utilizzare. Puoi specificare queste proprietà nel file gradle.build utilizzando un chiusura della configurazione l'attività e le proprietà.

Nell'esempio seguente:

La chiusura della configurazione del 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 un'unica riga:

  appengine.run.port = 8888

Consulta le sezioni seguenti per un elenco delle proprietà disponibili per ciascuna attività.

appengineStage

task(stage)

Genera una directory dell'applicazione per il deployment. appengineStage è utilizzato da l'attività appengineDeploy.

Puoi utilizzare le seguenti proprietà:

Proprietà	Descrizione
`compileEncoding`	La codifica dei caratteri da utilizzare durante la compilazione dei JSP. Si applica alle applicazioni in esecuzione solo nell'ambiente standard di App Engine.
`deleteJsps`	Elimina i file di origine JSP dopo la compilazione. Si applica alle applicazioni in esecuzione solo nell'ambiente standard di App Engine.
`disableJarJsps`	Disabilita l'aggiunta delle classi generate dai JSP. Si applica alle applicazioni in esecuzione solo nell'ambiente standard di App Engine.
`disableUpdateCheck`	Disabilita il controllo degli aggiornamenti della gcloud CLI.
`enableJarClasses`	Barattolo di `WEB-INF/classes content`. Si applica alle applicazioni in esecuzione solo nell'ambiente standard di App Engine.
`useMtimeFileWatcher`	Utilizza il polling mtime per rilevare le modifiche al codice sorgente. Utile se modifichi da una macchina remota usando un file system distribuito.
`enableJarSplitting`	Suddividi i file JAR di dimensioni superiori a 10 MB in frammenti più piccoli. Si applica al solo nell'ambiente standard di App Engine.
`enableQuickstart`	Usa la guida rapida di Eclipse Jetty per elaborare le annotazioni dei servlet. Si applica a solo nell'ambiente standard di App Engine.
`jarSplittingExcludes`	Escludi i file che corrispondono all'elenco di SUFFIXES separati da virgole da tutti i JAR . Si applica alle applicazioni in esecuzione in App Engine solo nell'ambiente standard.
`sourceDirectory`	Obbligatorio. Il percorso dei file di applicazioni web compilati oppure il è esplosa WAR. che viene utilizzata come origine per la gestione temporanea. Si applica al solo nell'ambiente standard di App Engine. Il valore predefinito è `build/exploded-${gradle-module-name}`.
`stagingDirectory`	Obbligatorio. La directory in cui posizionare l'applicazione in un'area intermedia. Il valore predefinito è `build/staged-app`.

appengineRun

task(run)

Esegue il server web di sviluppo di App Engine. Quando il server è in esecuzione, controlla continuamente se appengine-web.xml ha è cambiato. In caso affermativo, il server ricarica l'applicazione. Ciò significa che Non è necessario arrestare e riavviare l'applicazione a causa delle modifiche a appengine-web.xml.

Puoi utilizzare le seguenti proprietà, alcune delle quali corrispondono Flag della riga di comando del server di sviluppo locale:

Proprietà	Descrizione
`environment`	Una mappa delle variabili di ambiente da inviare al server di sviluppo locale. Esempio: `[key1: "value1", key2: "value2"]`
`jvmFlags`	Argomenti aggiuntivi da passare al comando java all'avvio di un'istanza un'istanza dell'app in esecuzione. Può essere specificato più di una volta. Esempio: `-Xmx1024m -Xms256m`
`host`	Nome host a cui devono essere associati i servizi delle applicazioni. Il valore predefinito è `localhost`.
`port`	Porta più bassa a cui devono essere associati i servizi delle applicazioni. Il valore predefinito è `8080`.
`serverVersion`	Versione server da avviare, le opzioni sono "1" e "2-alpha". Il valore predefinito è "1".
`services`	Obbligatorio. Percorsi di una directory contenente una directory contenente `WEB-INF/web.xml`. Il valore predefinito è `build/exploded-app`.
`startSuccessTimeout`	Intervallo di tempo in secondi di attesa per l'avvio del server di app per sviluppatori in in background (quando si utilizza appengineStart).

appengineDeploy

task(deploy)

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

Proprietà	Descrizione
`appEngineDirectory`	Posizione dei file di configurazione `.yaml` (cron, indice e così via) da quali deployment specifici della configurazione (appengineDeployCron ecc.) dal quale eseguire il deployment. Per le applicazioni standard, la configurazione di `.xml` i file vengono convertiti durante la gestione temporanea in `.yaml` e posizionati in `build/staged-app/WEB-INF/appengine-generated`.
`bucket`	Il bucket Google Cloud Storage utilizzato per lo stage dei file associati e deployment continuo. Se questo argomento non è specificato, lo stato predefinito in uso.
`imageUrl`	Esegui il deployment con un'immagine Docker specifica. L'URL Docker deve provenire da uno degli nomi host di Google Container Registry validi.
`projectId`	L'ID progetto della piattaforma Google Cloud da utilizzare per questa chiamata. Devi specificare un projectId oppure puoi impostare `GCLOUD_CONFIG` su utilizza il set di progetti nello stato di configurazione di gcloud.
`promote`	Promuovi la versione di cui è stato eseguito il deployment in modo che riceva tutto il traffico. Il valore predefinito è True.
`server`	Il server App Engine a cui connetterti. In genere, non è necessario per modificare questo valore.
`stopPreviousVersion`	Arresta la versione in esecuzione in precedenza quando esegui il deployment di una nuova versione riceve tutto il traffico.
`version`	La versione dell'app che verrà creata o sostituita da questo e deployment continuo. Se non specifichi una versione, ne verrà generata una per te.

Proprietà globali

Proprietà	Descrizione
`tools.cloudSdkHome`	Proprietà facoltativa per configurare la posizione di gcloud CLI. Se questa proprietà non viene specificata, il plug-in viene scaricato automaticamente con gcloud CLI.
`tools.cloudSdkVersion`	Parametro facoltativo per specificare la versione di gcloud CLI desiderata.