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

Dopo aver aggiunto il plug-in Gradle di App Engine al 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`	Esegue temporaneamente 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 le pagine relative a configurazione di Gretty e Gretty Tasks.

Per vedere un elenco di tutte le attività:

gradle tasks

Per ulteriori informazioni su come configurare e utilizzare Gradle, consulta la pagina relativa all'utilizzo di App Engine Gradle e il repository app-gradle-plugin su GitHub.

Proprietà attività

I contenuti del file gradle.build sono un insieme di regole che descrivono la tua build. Per descrivere le build, è scritto in un linguaggio specifico del dominio, basato sul linguaggio Groovy.

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

L'esempio seguente mostra come specificare le attività Gradle per Java 8. Per Java versione 11 e successive, consulta runtime Java per ulteriori informazioni sull'utilizzo delle versioni più recenti.

In questo esempio:

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

  appengine.deploy.stopPreviousVersion = true

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

appengineStage

attività(fase)

Genera una directory dell'applicazione per il deployment. Utilizzato dall'attività appengineDeploy e jettyRun.

Puoi utilizzare le seguenti proprietà:

Proprietà	Descrizione
`artifact`	Artefatto creato che contiene 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 dell'`Dockerfile`. Il valore predefinito è `src/main/docker`.
`stagingDirectory`	obbligatorio. La directory in cui posizionare l'applicazione. Il valore predefinito è `build/staged-app`.

appengineDeploy

task(deploy)

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

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 su un'unica riga:

  appengine.run.port = 8888

Proprietà	Descrizione
`appEngineDirectory`	Percorso dei file di configurazione `.yaml` (cron, index e così via) da cui verrà eseguito il deployment dei 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 posizionare temporaneamente 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 temporanea. Se non lo trova, tenta di generare automaticamente i file di configurazione necessari (ad esempio `app.yaml`) nella directory temporanea.
`imageUrl`	Eseguire il deployment con un'immagine Docker specifica. L'URL Docker deve provenire da uno dei nomi host di Google Container Registry validi.
`project`	Il nome del progetto della piattaforma Google Cloud da utilizzare per questa chiamata. Il valore predefinito è il progetto corrente selezionato durante l'inizializzazione dello strumento gcloud. Per la verifica, utilizza `gcloud config list project`.
`promote`	Promuovi la versione di cui è stato eseguito il deployment in modo da 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 automaticamente.

Proprietà globali

Proprietà	Descrizione
`tools.cloudSdkHome`	Proprietà facoltativa per configurare la località di Google Cloud CLI. In genere il plug-in lo rileva nell'interfaccia alla gcloud CLI quando viene installato con `gcloud components install app-engine-java`.