Nota: Java 8 è arrivato fine del supporto il 31 gennaio 2024. Le tue applicazioni Java 8 esistenti continueranno a essere eseguite e a ricevere traffico. Tuttavia, App Engine potrebbe bloccare il nuovo deployment delle applicazioni che utilizzano i runtime dopo la data di fine del supporto. Ti consigliamo di eseguire la migrazione all'ultima versione supportata di Java.

Questa pagina è stata tradotta dall'API Cloud Translation.

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

Dopo aver aggiunto il plug-in App Engine al progetto, puoi utilizzare i seguenti task Gradle specifici per App Engine per le applicazioni nell'ambiente standard di App Engine:

Attività	Descrizione
`tasks`	Visualizza le informazioni della guida sulle attività installate.
`appengineCloudSdkLogin`	Imposta lo stato globale della gcloud CLI per account.
`appengineDeploy`	Esegue il deployment e le fasi di un'applicazione in App Engine.
`appengineDeployAll`	Esegue il deployment e le fasi di un'applicazione con tutte le relative configurazioni yaml valide contemporaneamente in App Engine.
`appengineDeployCron`	Mette in fase ed esegue il deployment di una configurazione `cron.yaml` in App Engine.
`appengineDeployDispatch`	Esegue il deployment e le fasi di un file di configurazione `dispatch.yaml` in App Engine.
`appengineDeployDos`	Esegue il deployment e le fasi di un file di 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 è attivo, controlla 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, ma 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à delle attività

I contenuti del file gradle.build sono un insieme di regole per descrivere la build. È scritto in un linguaggio specifico per dominio per descrivere le build, basato sul linguaggio Groovy.

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

Nel seguente esempio:

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 solo alle applicazioni in esecuzione 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`	Disattiva l'aggiunta delle classi generate dalle JSP. Si applica solo alle applicazioni in esecuzione nell'ambiente standard di App Engine.
`disableUpdateCheck`	Disabilita il controllo degli aggiornamenti della gcloud CLI.
`enableJarClasses`	Aggiungi a Speciali `WEB-INF/classes content`. Si applica solo alle applicazioni in esecuzione nell'ambiente standard di App Engine.
`useMtimeFileWatcher`	Utilizza il polling mtime per rilevare le modifiche al codice sorgente. Utile se modifichi il codice da una macchina remota utilizzando 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`	Utilizza la guida rapida di Eclipse Jetty per elaborare le annotazioni dei servlet. Si applica solo all'ambiente standard di App Engine.
`jarSplittingExcludes`	Escludi i file che corrispondono all'elenco di SUFFIXES separati da virgole da tutti i JAR . Si applica solo alle applicazioni in esecuzione nell'ambiente standard di App Engine.
`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 solo all'ambiente standard di App Engine. Il valore predefinito è `build/exploded-${gradle-module-name}`.
`stagingDirectory`	Obbligatorio. La directory in cui eseguire l'implementazione dell'applicazione. Il valore predefinito è `build/staged-app`.

appengineRun

task(run)

Esegue il server web di sviluppo di App Engine. Quando il server viene è 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 ai 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 quando viene avviata un'istanza dell'app. Può essere specificato più di una volta. Esempio: `-Xmx1024m -Xms256m`
`host`	Nome host a cui devono essere associati i servizi dell'applicazione. Il valore predefinito è `localhost`.
`port`	Porta minima a cui devono essere associati i servizi di applicazione. 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(deployment)

Esegue il deployment e le fasi di un'applicazione in App Engine.

Proprietà	Descrizione
`appEngineDirectory`	Posizione dei file di configurazione `.yaml` (cron, index e così via) da cui verranno eseguiti i deployment di configurazioni specifiche (appengineDeployCron e così via). 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 eseguire il commit dei file associati al deployment. Se questo parametro non viene specificato, viene utilizzato il bucket predefinito dell'applicazione.
`imageUrl`	Esegui il deployment con un'immagine Docker specifica. L'URL di Docker deve provenire da uno dei nomi host di Google Container Registry validi.
`projectId`	L'ID progetto Google Cloud da utilizzare per questa chiamata. Devi specificare un projectId oppure puoi impostare `GCLOUD_CONFIG` su usa 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 connettersi. 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 è specificata, il plug-in scarica automaticamente la CLI gcloud.
`tools.cloudSdkVersion`	Parametro facoltativo per specificare la versione di gcloud CLI che preferisci.