Utilizzo di Apache Maven e del plug-in App Engine

Apache Maven è uno strumento di automazione della compilazione 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 i progetti Enterprise Archive (EAR).

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 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 dell'interfaccia a riga di comando gcloud:

    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 per App Engine al file pom.xml del progetto, puoi utilizzare il seguente comando per eseguire il deployment dell'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.

Modifica delle impostazioni predefinite del deployment

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

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

Puoi anche usare il comando appengine:deploy per eseguire il deployment dei file di configurazione, ad esempio cron.yaml, dispatch.yaml e index.yaml.

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

Passaggi successivi