Utilizzo di Apache Maven e del plug-in App Engine

Apache Maven è un strumento di automazione della creazione di applicazioni per Java.

App Engine fornisce un plug-in Maven che puoi utilizzare per creare ed eseguire il deployment della tua app in App Engine. Il plug-in non supporta le aziende Progetti EAR (Application Archive).

Prima di iniziare

  1. Per determinare se Maven è installato e quale versione hai, esegui il seguente comando:

    mvn -v

    Se Maven è installato, viene visualizzata una lunga stringa di informazioni che inizia con Apache Maven e seguita da un numero di versione come 3.5.

  2. Se non hai installato Maven 3.5 o versioni successive:

    1. Scarica Maven 3.5 o versioni successive.
    2. Installa Maven 3.5 o versioni successive.

  3. Se non lo hai già fatto, segui i passaggi qui per scaricare gcloud CLI, creare il tuo progetto Google Cloud inizializza l'app di App Engine.

  4. Installa il componente app-engine-java della gcloud CLI:

    gcloud components install app-engine-java

Aggiunta del plug-in Maven App Engine

Per utilizzare il plug-in Maven di App Engine, aggiungi le seguenti righe alla sezione plugins in il file pom.xml del tuo progetto:

<plugin>
   <groupId>com.google.cloud.tools</groupId>
   <artifactId>appengine-maven-plugin</artifactId>
   <version>2.7.0</version>
</plugin>

Creazione e deployment dell'app

Dopo aver aggiunto il plug-in Maven di App Engine al campo pom.xml del progetto puoi usare questo comando per creare il deployment della tua app:

mvn package appengine:deploy -Dapp.deploy.projectId=PROJECT_ID

Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud. Se il tuo file pom.xml specifica già il tuo ID progetto , non è necessario includere la proprietà -Dapp.deploy.projectId nel comando eseguito.

L'obiettivo package crea e pacchettizza la tua app, mentre Obiettivo: appengine:deploy svolge le seguenti operazioni:

  1. Genera un ID versione univoco per la nuova versione dell'app.

  2. Esegue il deployment della nuova versione in App Engine.

  3. Instrada tutto il traffico alla nuova versione.

Modificare i valori predefiniti del deployment

Puoi modificare il comportamento predefinito del deployment passando i parametri nel campo Comando appengine:deploy. Ad esempio, il comando seguente esegue il deployment definito nel file pom.xml a uno specifico progetto Google Cloud, assegna un ID versione personalizzato al servizio e disattiva il traffico automatico routing per la nuova versione:

mvn appengine:deploy -Dapp.deploy.projectId=PROJECT_ID -Dapp.deploy.version=VERSION_ID -Dapp.deploy.promote=False

Puoi anche utilizzare il comando appengine:deploy per eseguire il deployment di file di configurazione, come cron.yaml, dispatch.yaml e index.yaml.

Per ulteriori informazioni, consulta il appengine:deploy documento di riferimento .

Passaggi successivi