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

Dopo aver aggiunto il plug-in Gradle di App Engine al tuo 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 una 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 una 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 trovare scopri di più sul plug-in Gratty, consulta la sezione Configurazione di Gratty. e Gretty Tasks.

Per visualizzare un elenco di tutte le attività:

gradle tasks

Per saperne di più su come configurare e utilizzare Gradle, vedi Utilizzando Gradle di App Engine e ai app-gradle-plugin su GitHub.

Proprietà attività

I contenuti del file gradle.build sono un insieme di regole per descrivere creare. È scritto in un linguaggio specifico per il dominio per descrivere le build, il 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à.

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

  appengine.deploy.stopPreviousVersion = true

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

appengineStage

task(stage)

Genera una directory dell'applicazione per il deployment. Usato da appengineDeploy e l'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.

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
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 flessibili, l'impostazione predefinita è src/main/appengine.
bucket Il bucket Cloud Storage utilizzato per lo stage dei file associati e deployment continuo. Se questo argomento non è specificato, lo stato predefinito in uso.
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 che non viene trovato, tenta di generare automaticamente le di configurazione temporanea (ad esempio app.yaml) nella gestione temporanea .
imageUrl Esegui il deployment con un'immagine Docker specifica. L'URL Docker deve provenire da uno degli nomi host Artifact Registry validi.
project Il nome del progetto della piattaforma Google Cloud da utilizzare per questa chiamata. Predefinito è il progetto attuale selezionato inizializzando lo strumento gcloud. Per verificare: usa 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 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 località di Google Cloud CLI. In genere il plug-in lo rileva in gcloud CLI quando viene installato con gcloud components install app-engine-java.