Questa pagina è stata tradotta dall'API Cloud Translation.

Attività e proprietà del plug-in Gradle di 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`	Mostra le informazioni della guida sulle attività installate.
`appengineStage`	Genera una directory dell'applicazione per il deployment.
`appengineDeploy`	Organizza in fasi 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 Gratty, consulta le pagine relative a Configurazione di Gratty 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à attività

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

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

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 ciascuna 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 con tutte le classi, le risorse e i manifest. Il valore predefinito è `build/libs/[YOUR_SERVLET].war`.
`appEngineDirectory`	Percorso del file `app.yaml`. Il valore predefinito è `src/main/appengine`.
`dockerDirectory`	Posizione dell'oggetto `Dockerfile`. Il valore predefinito è `src/main/docker`.
`stagingDirectory`	Obbligatorio. La directory in cui posizionare l'applicazione in un'area intermedia. Il valore predefinito è `build/staged-app`.

appengineDeploy

task(deployment)

Organizza in fasi 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`	Posizione dei file di configurazione `.yaml` (cron, indice e così via) da cui verrà eseguito il deployment dei deployment specifici di configurazione (appengineDeployCron e così via. Per le applicazioni flessibili, l'impostazione predefinita è `src/main/appengine`.
`bucket`	Bucket Cloud Storage utilizzato per lo stage dei file associati al deployment. Se questo argomento non è 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 viene trovato, tenta di generare automaticamente i file di configurazione necessari (ad esempio `app.yaml`) nella directory temporanea.
`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 della piattaforma Google Cloud da utilizzare per questa chiamata. Il valore predefinito è il progetto corrente 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 in modo che riceva tutto il traffico. Il valore predefinito è True.
`server`	Il server App Engine a cui connetterti. In genere, non è necessario modificare questo valore.
`stopPreviousVersion`	Interrompi la versione precedentemente in esecuzione 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 trova in gcloud CLI quando è installato con `gcloud components install app-engine-java`.