Diese Anleitung richtet sich an alle Nutzer, die sich mit dem Erstellen von Anwendungen in der Cloud vertraut machen möchten, z. B. Software- oder Webentwickler, die die grundlegenden Konzepte der Anwendungsentwicklung im Zusammenhang mit Google Cloud kennenlernen möchten.
Lernziele
- Grundlegende Google Cloud-Tools wie die Google Cloud Console und
gcloud
kennenlernen. - Anwendungen in Cloud Run bereitstellen
- Daten mit Firestore dauerhaft speichern
- Datei-Uploads in Cloud Storage speichern
- Anwendungen mit der Operations-Suite von Google Cloud überwachen
Kosten
In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:
Die Anleitungen in diesem Dokument wurden so gestaltet, dass Ihre Ressourcennutzung innerhalb der Limits der Stufe Immer kostenlos von Google Cloud bleibt.
Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.
Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.
Hinweis
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Mit den folgenden Schritten können Sie eine Firebase-Datenbank im nativen Modus erstellen:
-
Rufen Sie in der Cloud Console die Seite Firestore-Betrachter auf.
Zur Firestore-Seite - Klicken Sie auf dem Bildschirm Cloud Firestore-Modus auswählen auf Nativen Modus auswählen.
- Wählen Sie einen Standort für Ihre Firestore-Datenbank aus. Mit dieser Standorteinstellung legen Sie den Standardspeicherort für Google Cloud-Ressourcen in Ihrem Cloud-Projekt fest. Er wird für Google Cloud-Dienste in Ihrem Cloud-Projekt verwendet, die eine Standorteinstellung benötigen. Dabei geht es speziell um Ihren standardmäßigen Cloud Storage-Bucket und Ihre App Engine-Anwendung.
- Klicken Sie auf Datenbank erstellen.
-
Rufen Sie in der Cloud Console die Seite Firestore-Betrachter auf.
-
Cloud Run Admin, Cloud Storage, Cloud Logging, and Error Reporting APIs aktivieren.
-
Klonen Sie das Beispiel-Repository und öffnen Sie die Beispielanwendung in Cloud Shell:
Zu Cloud ShellCloud Shell bietet Ihnen eine Befehlszeile, mit der Sie direkt über den Browser auf Google Cloud-Ressourcen zugreifen können.
- Klicken Sie auf Weiter, um den Beispielcode herunterzuladen und ins Anwendungsverzeichnis zu wechseln.
-
Konfigurieren Sie in Cloud Shell das
gcloud
-Tool, um das neue Google Cloud-Projekt zu verwenden:# Configure gcloud for your project gcloud config set project PROJECT_ID
Ersetzen Sie PROJECT_ID durch die Google Cloud-Projekt-ID, die Sie mit der Cloud Console erstellt haben.
Die Google Cloud-Befehlszeile ist die primäre Möglichkeit, mit Ihren Google Cloud-Ressourcen über die Befehlszeile zu interagieren. In dieser Anleitung verwenden Sie das
gcloud
-Tool, um Ihre Anwendung bereitzustellen und zu beobachten.
Anwendung ausführen
- Wenn Sie Cloud Shell bereits nutzen und für die Verwendung von Java 11 konfiguriert haben, aktualisieren Sie die Java-Alternativen – die Umgebungsvariablen
JAVA_HOME
undPATH
– der Shell auf Java 8. -
Wechseln Sie zum Verzeichnis
bookshelf/1-cloud-run
und führen Sie die Anwendung aus: Ersetzen SieGOOGLE_CLOUD_PROJECT=PROJECT_ID mvn -Plocal clean jetty:run-exploded
PROJECT_ID
durch die ID des von Ihnen erstellten Google Cloud-Projekts. - Klicken Sie in Cloud Shell auf Webvorschau und wählen Sie dann Vorschau auf Port 8080 aus. Ein neues Fenster mit der ausgeführten Anwendung wird geöffnet.
Anwendung in Cloud Run bereitstellen
Google Cloud bietet mehrere Optionen zum Ausführen des Codes. In diesem Beispiel verwenden Sie Cloud Run zum Bereitstellen einer skalierbaren Anwendung in Google Cloud. Bei Cloud Run müssen Sie keine Server verwalten und automatisch skalieren, um Trafficspitzen zu unterstützen.
- Erstellen Sie das Image mit Jib:
mvn package jib:build -Dimage=gcr.io/PROJECT_ID/bookshelf
Ersetzen Sie
PROJECT_ID
durch die von Ihnen erstellte Google Cloud-Projekt-ID. - Stellen Sie das Image bereit:
Ersetzen Siegcloud run deploy bookshelf --image gcr.io/
PROJECT_ID
/bookshelf \ --platform managed --region us-central1 --allow-unauthenticatedPROJECT_ID
durch die von Ihnen erstellte Google Cloud-Projekt-ID.
Nach erfolgreicher Bereitstellung wird ein Endpunkt ausgegeben, der in Cloud Run im folgenden Format ausgeführt wird:
https://bookshelf-abcdefghij-uc.a.run.app
Der Code Ihrer Anwendung ist jetzt unter diesem Link aufrufbar, der im Folgenden YOUR_CODE_RUN_URL genannt werden soll. Geben Sie die URL in einen Webbrowser ein, um die Anwendung aufzurufen.
Daten mit Firestore dauerhaft speichern
Sie können keine Informationen auf Ihren Cloud Run-Instanzen speichern, da sie beim Neustart der Instanz verloren gehen und beim Erstellen neuer Instanzen nicht vorhanden sind. Stattdessen verwenden Sie eine Datenbank, aus der Ihre Instanzen lesen bzw. in die sie schreiben.
Google Cloud bietet mehrere Optionen zum Speichern von Daten. In diesem Beispiel verwenden Sie Firestore zum Speichern der Daten für jedes Buch. Firestore ist eine vollständig verwaltete, serverlose NoSQL-Dokumentendatenbank, in der Sie Daten speichern und abfragen können. Firestore skaliert automatisch, um die Anwendungsanforderungen zu erfüllen; wenn Sie die Anwendung nicht nutzen, skaliert Firestore auf null. Fügen Sie jetzt das erste Buch hinzu.
- Rufen Sie in Ihrem Webbrowser YOUR_CODE_RUN_URL auf.
-
Zum Erstellen eines Buchs für die bereitgestellte Anwendung klicken Sie auf Add book (Buch hinzufügen).
- Geben Sie im Feld Titel
Moby Dick
ein. - Geben Sie im Feld Autor
Herman Melville
ein. -
Klicken Sie auf Speichern. Die Bookshelf-Anwendung enthält jetzt einen Eintrag.
-
Klicken Sie in der Cloud Console auf Aktualisieren refresh, um die Firestore-Seite zu aktualisieren.
Die Daten sind in Firestore zu sehen. In der Bookshelf-Anwendung wird jedes Buch als Firestore-Dokument mit einer eindeutigen ID gespeichert. All diese Dokumente werden in einer Firestore-Sammlung gespeichert.
In dieser Anleitung wird die Sammlung „books“ genannt.
Firestore speichert die Bücher mithilfe der Firestore-Clientbibliothek. Hier ein Beispiel zum Abrufen eines Firestore-Dokuments:
Weitere Informationen zum Verwenden von Firestore finden Sie unter Daten in Firestore hinzufügen.
Datei-Uploads in Cloud Storage speichern
Nachdem Sie ein Buch hinzugefügt haben, soll nun auch noch ein Bild des Buchcovers hinzugefügt werden. Dateien können nicht in Instanzen gespeichert werden. Eine Datenbank ist auch nicht der richtige Ort für Bilddateien. Verwenden Sie stattdessen Cloud Storage.
Cloud Storage ist der primäre Blob-Speicher für Google Cloud. Sie können mit Cloud Storage Anwendungs-Assets hosten, die Sie in der Google Cloud freigeben möchten. Zur Verwendung von Cloud Storage müssen Sie einen Cloud Storage-Bucket – einen Basiscontainer für Daten – erstellen.
- Rufen Sie in der Cloud Console die Seite Cloud Storage-Browser auf.
- Klicken Sie auf Bucket erstellen.
- Geben Sie im Dialogfeld Bucket erstellen einen Namen für den Bucket ein, indem Sie die Google Cloud-Projekt-ID vor dem String
_bucket
einfügen, sodass der NameYOUR_PROJECT_ID_bucket
lautet. Der Name unterliegt den Anforderungen für Bucket-Namen. Bei allen übrigen Feldern können die Standardwerte übernommen werden. - Klicken Sie auf Erstellen.
- Nach dem Erstellen des Buckets müssen Objekte öffentlich zugänglich gemacht werden, damit Nutzer sie aufrufen können. Informationen dazu, wie Sie Objekte öffentlich zugänglich machen, finden Sie unter Daten öffentlich machen.
-
Klicken Sie auf Buch bearbeiten und wählen Sie ein Bild als Buchcover zum Hochladen aus. Sie können beispielsweise dieses urheberrechtsfreie Bild verwenden:
-
Klicken Sie auf Speichern. Sie werden zur Startseite weitergeleitet, auf der sich ein Eintrag für Ihre Bookshelf-Anwendung befindet.
Die Bookshelf-Anwendung sendet hochgeladene Dateien über die Cloud Storage-Clientbibliothek an Cloud Storage.
Weitere Informationen zur Verwendung von Cloud Storage finden Sie in der Liste der Anleitungen.
Anwendung mit der Operations-Suite von Google Cloud überwachen
Sie haben Ihre Anwendung bereitgestellt und Bücher erstellt und bearbeitet. Diese Ereignisse können Sie für Ihre Nutzer mit Application Performance Management überwachen.
Logs mit Cloud Logging überwachen
-
Rufen Sie in der Google Cloud den Log-Explorer auf.
Zum Log-ExplorerHier können Sie die Anwendung in Echtzeit überwachen. Bei Problemen mit Ihrer Anwendung ist dies einer der ersten Anlaufpunkte.
- Wählen Sie in der Drop-down-Liste Ressource die Option Überarbeitung in Cloud Run, Bookshelf aus.
Fehler mithilfe von Error Reporting überwachen
-
Rufen Sie in der Cloud Console die Seite Error Reporting auf.
Zur Seite „Error Reporting“
In Error Reporting werden Fehler und Ausnahmen in der Anwendung hervorgehoben. Sie können auch diesbezügliche Benachrichtigungen einrichten. -
Rufen Sie im Browser die
/errors
-URL in der Anwendung auf.
YOUR_CODE_RUN_URL/errors
Dadurch wird eine neue Testausnahme generiert und an die Operations-Suite von Google Cloud gesendet.
-
Kehren Sie in der Cloud Console zur Seite Error Reporting zurück. Kurz darauf ist der neue Fehler sichtbar. Klicken Sie auf Automatische Aktualisierung, damit Sie die Seite nicht manuell aktualisieren müssen.
Bereinigen
Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.
Projekt löschen
- Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.
- Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
- Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.