Kurzanleitung für Java in der App Engine-Standardumgebung

Regions-ID

REGION_ID ist ein abgekürzter Code, den Google anhand der Region zuweist, die Sie beim Erstellen Ihrer Anwendung ausgewählt haben. Der Code bezieht sich nicht auf ein Land oder eine Provinz, auch wenn einige Regions-IDs häufig verwendeten Länder- und Provinzcodes ähneln können. Das Einbinden von REGION_ID.r in App Engine-URLs ist für vorhandene Anwendungen optional und wird bald für alle neuen Anwendungen erforderlich sein.

Für einen reibungslosen Übergang wird App Engine nach und nach für die Verwendung von Regions-IDs aktualisiert. Wenn Ihr Google Cloud-Projekt noch nicht aktualisiert wurde, wird für Ihre Anwendung keine Regions-ID angezeigt. Da die ID für vorhandene Anwendungen optional ist, müssen Sie keine URLs aktualisieren oder andere Änderungen vornehmen, wenn die Regions-ID für Ihre vorhandenen Anwendungen verfügbar wird.

Hier finden Sie weitere Informationen zu Regions-IDs.

Dieser Schnellstart zeigt, wie Sie in App Engine eine Beispielanwendung bereitstellen. Informationen zum Codieren einer Anwendung für App Engine finden Sie unter Anwendung erstellen.

Kosten

Für diesen Leitfaden fallen keine Kosten an. Wenn Sie nur diese Beispielanwendung ausführen, wird Ihr kostenloses Kontingent nicht überschritten.

Hinweis

In dieser Kurzanleitung wird davon ausgegangen, dass Sie das Java SE 11 Development Kit (JDK) installiert haben.

Bevor Sie diese Kurzanleitung ausführen und bereitstellen, müssen Sie das Cloud SDK installieren und dann ein Cloud-Projekt für App Engine einrichten:

  1. Laden Sie das Cloud SDK herunter und installieren Sie es:

    SDK herunterladen

    Hinweis: Wenn Sie das Cloud SDK bereits installiert haben, aktualisieren Sie es mit dem folgenden Befehl:

    gcloud components update
    
  2. Erstellen Sie ein neues Projekt:

    gcloud projects create [YOUR_PROJECT_ID] --set-as-default
    

    Ersetzen Sie [YOUR_PROJECT_ID] durch einen String, der Ihr Projekt eindeutig identifiziert. Beispiel: my-project-24.

    Mit dem Flag --set-as-default wird das neue Projekt als Standardprojekt festgelegt, das von gcloud verwendet wird.

    Überprüfen Sie, ob das Projekt erstellt wurde:

    gcloud projects describe [YOUR_PROJECT_ID]
    

    Die Projektdetails könnten so aussehen:

    createTime: year-month-hour
    lifecycleState: ACTIVE
    name: project-name
    parent:
      id: '433637338589'
      type: organization
    projectId: project-name-id
    projectNumber: 499227785679
    
  3. Initialisieren Sie die App Engine-Anwendung mit Ihrem Projekt und wählen Sie die Region aus:

    gcloud app create --project=[YOUR_PROJECT_ID]
    

    Wählen Sie bei entsprechender Aufforderung die Region aus, in der sich die App Engine-Anwendung befinden soll.

  4. Die Abrechnung für das Projekt muss aktiviert sein. Es muss ein Rechnungskonto mit dem Projekt verknüpft sein, damit die Anwendung in App Engine bereitgestellt werden kann.

    Abrechnung aktivieren

  5. Installieren Sie folgende Abhängigkeiten:

App Engine-Standorte

App Engine ist regional, was bedeutet, dass sich die Infrastruktur, in der Ihre Anwendungen ausgeführt werden, in einer bestimmten Region befindet und Google sie so verwaltet, dass sie redundant in allen Zonen innerhalb dieser Region verfügbar ist.

Die Erfüllung der Latenz-, Verfügbarkeits- oder Langlebigkeitsanforderungen ist der wichtigste Gesichtspunkt bei der Auswahl der Region, in der Ihre Anwendungen ausgeführt werden sollen. Sie können normalerweise die Region auswählen, die den Nutzern Ihrer Anwendung am nächsten ist. Sie sollten jedoch die Standorte, an denen App Engine verfügbar ist und die Standorte der anderen Google Cloud-Produkte und -Dienste berücksichtigen, die Ihre Anwendung nutzt. Eine standortübergreifende Nutzung von Diensten kann die Latenz der Anwendung sowie die Preise beeinflussen.

Sie können die Region einer Anwendung nicht mehr ändern, nachdem Sie sie festgelegt haben.

Wenn Sie bereits eine App Engine-Anwendung erstellt haben, können Sie die Region mit einer der folgenden Methoden aufrufen:

Hello World-App herunterladen

Wir haben eine einfache Hello-World-Anwendung für Java 11 entwickelt, mit der Sie schnell ein Gefühl für die Bereitstellung einer Anwendung in Google Cloud entwickeln können.

  1. Klonen Sie das Repository der Hello-World-Beispielanwendung auf dem lokalen Computer:

    git clone https://github.com/GoogleCloudPlatform/java-docs-samples
    

    Sie können das Beispiel auch als ZIP-Datei herunterladen und extrahieren.

  2. Wechseln Sie zu dem Verzeichnis, das den Beispielcode enthält:

    cd java-docs-samples/appengine-java11/springboot-helloworld
    

Hello World auf lokalem Computer ausführen

So führen Sie die Hello World App auf einem lokalen Computer aus:

  1. Starten Sie einen lokalen Webserver mithilfe des Spring Boot Maven-Plug-ins.
    mvn spring-boot:run
  2. Geben Sie im Webbrowser die folgende Adresse ein:

    http://localhost:8080

Auf der Seite wird die Nachricht Hello World aus der Beispielanwendung angezeigt. Drücken Sie im Terminalfenster Strg + C, um den Webserver zu beenden.

Hello World in App Engine bereitstellen und ausführen

So stellen Sie die Anwendung in der App Engine-Standardumgebung bereit:

  1. Führen Sie den folgenden Befehl im Verzeichnis springboot-helloworld aus, um die Anwendung "Hello World" bereitzustellen:

    gcloud app deploy

    Hier finden Sie Informationen zu optionalen Flags.

    Häufig verwendete gcloud-Befehls-Flags

    • Verwenden Sie das Flag --version, um eine eindeutige ID festzulegen, die die Version Ihrer Anwendung angibt. Andernfalls wird automatisch eine ID generiert. Beispiel: --version [YOUR_VERSION_ID]
    • Mit dem Flag --project können Sie eine andere Cloud Console-Projekt-ID als jene angeben, die Sie im gcloud-Tool als Standard initialisiert haben. Beispiel: --project [YOUR_PROJECT_ID]

    Beispiel:

    gcloud app deploy --version pre-prod-5 --project my-sample-app

    Weitere Informationen zum Bereitstellen der Anwendung über die Befehlszeile finden Sie unter Anwendung bereitstellen und testen. Eine Liste aller Befehls-Flags finden Sie in der Referenz zu gcloud app deploy.

  2. Starten Sie den Browser und rufen Sie die Anwendung unter https://PROJECT_ID.REGION_ID.r.appspot.com auf.

    gcloud app browse
    Dabei ist PROJECT_ID Ihre Google Cloud-Projekt-ID.

Dieses Mal wird die Seite mit der Nachricht „Hello World” von einem Webserver bereitgestellt, der auf einer App Engine-Instanz ausgeführt wird.

Das wars! Sie haben Ihre erste Java 11-Anwendung in der App Engine-Standardumgebung bereitgestellt.

In den folgenden Abschnitten finden Sie Informationen zur Bereinigung sowie Links für mögliche weitere Schritte.

Bereinigen

Um Gebühren zu vermeiden, können Sie Ihr Cloud-Projekt löschen und so die Abrechnung für alle in diesem Projekt verwendeten Ressourcen beenden.

  1. Wechseln Sie in der Cloud Console zur Seite Ressourcen verwalten.

    Zur Seite „Ressourcen verwalten“

  2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
  3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.

Weitere Informationen

Informationen zur Plattform

Sie wissen jetzt, wie Sie Anwendungen in App Engine entwickeln und bereitstellen. Nun können Sie sich mit den weiteren Bereichen von Google Cloud vertraut machen. Sie haben bereits das Cloud SDK installiert, mit dem Sie die Tools zur Interaktion mit Produkten wie z. B. Cloud SQL, Cloud Storage, Firestore nutzen können.

Informationen zur App Engine-Standardumgebung

Im Folgenden finden Sie weitere Themen zu App Engine: