Apache Maven und App Engine-Plug-in verwenden

Apache Maven ist ein Build-Automatisierungstool für Java.

App Engine bietet ein Maven-Plug-in, mit dem Sie Ihre Anwendung erstellen und in App Engine bereitstellen können. Das Plug-in unterstützt keine Enterprise Application Archive(EAR)-Projekte.

Hinweis

  1. Ermitteln Sie mit dem folgenden Befehl, ob Maven installiert ist und welche Version Sie haben:

    mvn -v

    Wenn Maven installiert ist, wird ein langer String mit Informationen angezeigt, der mit Apache Maven beginnt. Darauf folgt eine Versionsnummer wie 3.9.1.

  2. Wenn Maven 3.9.1 oder höher nicht installiert ist:

    1. Laden Sie Maven 3.9.1 oder höher herunter.
    2. Installieren Sie Maven 3.9.1 oder höher.

    Standardmäßige Linux-Paketmanager wie apt oder apt-get unter Ubuntu und Debian stellen ältere Maven-Versionen bereit und enthalten möglicherweise nicht Maven 3.9.1 oder höher. Wenn Sie eine unterstützte Version unter Linux installieren möchten, laden Sie das Binärarchiv direkt von der Apache Maven-Website herunter und folgen Sie der Installationsanleitung.

  3. Führen Sie, falls noch nicht erfolgt, die folgenden Schritte aus, um die gcloud CLI herunterzuladen, Ihr Google Cloud Projekt zu erstellen und Ihre App Engine-Anwendung zu initialisieren.

  4. Installieren Sie die app-engine-java-Komponente der gcloud CLI:

    gcloud components install app-engine-java

App Engine Maven-Plug-in hinzufügen

Wenn Sie das App Engine Maven-Plug-in verwenden möchten, fügen Sie dem Abschnitt plugins in der Datei pom.xml Ihres Projekts die folgenden Zeilen hinzu:

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

Anwendung erstellen und bereitstellen

Nachdem Sie das Maven-Plug-in für App Engine der Datei pom.xml Ihres Projekts hinzugefügt haben, können Sie Ihre Anwendung mit dem folgenden Befehl erstellen:

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

Ersetzen Sie PROJECT_ID durch die ID Ihres Projekts von Google Cloud . Wenn in der Datei pom.xml bereits Ihre Projekt-ID angegeben ist, müssen Sie das Attribut -Dapp.deploy.projectId nicht in dem von Ihnen ausgeführten Befehl einfügen.

Mit dem Ziel package wird die Anwendung erstellt und gepackt und das Ziel appengine:deploy führt Folgendes aus:

  1. Generiert eine eindeutige Versions-ID für die neue Version Ihrer App.

  2. Stellt die neue Version in App Engine bereit.

  3. Leitet den gesamten Traffic zur neuen Version weiter.

Standardeinstellungen für die Bereitstellung ändern

Sie können das Standardbereitstellungsverhalten ändern, indem Sie Parameter im Befehl appengine:deploy übergeben. Mit dem folgenden Befehl wird beispielsweise der in der Datei pom.xml definierte Dienst in einem bestimmten Projekt Google Cloud bereitgestellt, dem Dienst wird eine benutzerdefinierte Versions-ID zugewiesen und das automatische Traffic-Routing für die neue Version wird deaktiviert:

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

Sie können auch den Befehl appengine:deploy verwenden, um Konfigurationsdateien wie cron.yaml, dispatch.yaml und index.yaml bereitzustellen.

Weitere Informationen finden Sie in der Referenz zu appengine:deploy.

Nächste Schritte