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 i progetti Enterprise Application Archive (EAR).

Prima di iniziare

  1. Per determinare se Maven è installato e quale versione è in uso, 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 della gcloud CLI:

    gcloud components install app-engine-java

Aggiunta del plug-in Maven di App Engine

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

<plugins>
   <plugin>
     <groupId>com.google.cloud.tools</groupId>
     <artifactId>appengine-maven-plugin</artifactId>
     <version>2.7.0</version>
   </plugin>
   <plugin>
     <groupId>org.eclipse.jetty</groupId>
     <artifactId>jetty-maven-plugin</artifactId>
     <version>9.3.7.v20160115</version>
   </plugin>
</plugins>
 Il plug-in App Engine include il plug-in Jetty Maven, che puoi utilizzare per testare l'applicazione rapidamente senza creare un file WAR.

Usare il plug-in Jetty Maven per testare l'app localmente

Durante la fase di sviluppo, puoi eseguire e testare l'app in qualsiasi momento nelle il server di sviluppo richiamando il plug-in Jetty Maven.

Per eseguire l'app nel server di sviluppo:

  1. Crea la tua app se non l'hai ancora fatto:

    mvn package

  2. Cambia directory al livello superiore del progetto (ad esempio myapp) e esegui l'app richiamando Maven:

    mvn jetty:run

  3. Attendi l'avvio del server e utilizza il browser per visitarlo http://localhost:8080/ per accedere alla tua app.

  4. Arresta l'app e il server di sviluppo premendo Ctrl+C.

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 pom.xml file specifica ID progetto, non devi includere la proprietà -Dapp.deploy.projectId nell' il comando che esegui.

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 predefinito del deployment passando i parametri nel campo Comando appengine:deploy. Ad esempio, il comando seguente 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