Jetzt starten mit Node.js

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.

Ziele

• Grundlegende Google Cloud-Tools wie die Google Cloud Console und gcloud kennenlernen
• Anwendungen in der App Engine-Standardumgebung 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:

• App Engine
• Cloud Storage
• Firestore
• Operations-Suite 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. Neuen Google Cloud-Nutzern steht möglicherweise eine kostenlose Testversion zur Verfügung.

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.

Vorbereitung

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

6. Mit den folgenden Schritten können Sie eine Firebase-Datenbank im nativen Modus erstellen:
   1. Rufen Sie in der Cloud Console die Firestore-Seite auf.
      Zur Firestore-Seite
   2. Klicken Sie im Bildschirm Firestore-Modus auswählen auf Nativen Modus auswählen.
   3. 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.
      Achtung: Sobald Sie den Standardspeicherort für Ressourcen in Ihrem Cloud-Projekt festgelegt haben, können Sie ihn nicht mehr ändern.
   4. Klicken Sie auf Datenbank erstellen.

7. Enable the App Engine Admin, Cloud Storage, Cloud Logging, and Error Reporting APIs.

   Enable the APIs

8. Klonen Sie das Beispiel-Repository und öffnen Sie die Beispielanwendung in Cloud Shell:
   Zu Cloud Shell

   Cloud Shell bietet Ihnen direkt über den Browser Befehlszeilenzugriff auf Ihre Google Cloud-Ressourcen.

9. Klicken Sie auf Fortfahren, um den Beispielcode herunterzuladen und in das Anwendungsverzeichnis zu wechseln.

10. 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 Methode zum Interagieren mit Google Cloud-Ressourcen über die Befehlszeile. In dieser Anleitung verwenden Sie das gcloud-Tool zum Bereitstellen und Überwachen der Anwendung.

Anwendung ausführen

1. Installieren Sie die Abhängigkeiten der Anwendung mit dem Befehl npm:

   npm install
   

2. Führen Sie die Anwendung aus:

   npm start
   

3. 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 App Engine bereitstellen

Google Cloud bietet mehrere Optionen zum Ausführen des Codes. In diesem Beispiel verwenden Sie App Engine zum Bereitstellen einer skalierbaren Anwendung in Google Cloud. Dank Bereitstellungen ohne Konfigurationsaufwand und ohne Serververwaltung können Sie sich mit App Engine ganz auf das Schreiben von Code konzentrieren. Außerdem skaliert App Engine automatisch und unterstützt so plötzlich auftretende Trafficspitzen.

Die app.yaml-Datei ist Ihre Hauptkonfigurationsdatei zum Bereitstellen in App Engine:

bookshelf/app.yaml

Auf GitHub ansehen

runtime: nodejs10

instance_class: F2

1. Stellen Sie im Terminalfenster die Anwendung mithilfe der gcloud-Befehlszeile in App Engine bereit:

   # on the command-line
   gcloud app deploy

2. Geben Sie im Webbrowser die folgende URL ein:

   https://PROJECT_ID.REGION_ID.r.appspot.com

   Ersetzen Sie Folgendes:

   • PROJECT_ID: Ihre Google Cloud-Projekt-ID
   • REGION_ID: Ein Code, der Ihrer Anwendung von App Engine zugewiesen wird
   
   Hinweis: Diese SSL-geschützte Domain wird automatisch erstellt und ist hilfreich für die Entwicklung. Sie können mit App Engine auch eine benutzerdefinierte Domain einrichten.

Weitere Informationen zur Bereitstellung in App Engine finden Sie unter Node.js 10-Laufzeitumgebung.

Daten mit Firestore dauerhaft speichern

Sie können keine Daten in App Engine-Instanzen speichern, da diese verloren gehen, wenn die Instanz neu gestartet wird, bzw. nicht vorhanden sind, wenn neue Instanzen erstellt werden. 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.

1. Geben Sie im Webbrowser die folgende URL ein:

   https://PROJECT_ID.REGION_ID.r.appspot.com

   Ersetzen Sie Folgendes:

   • PROJECT_ID: Ihre Google Cloud-Projekt-ID
   • REGION_ID: Ein Code, der Ihrer Anwendung von App Engine zugewiesen wird

2. Zum Erstellen eines Buchs für die bereitgestellte Anwendung klicken Sie auf Buch hinzufügen.

   
3. Geben Sie im Feld Titel Moby Dick ein.
4. Geben Sie im Feld Autor Herman Melville ein.

5. Klicken Sie auf Speichern. Die Bookshelf-Anwendung enthält jetzt einen Eintrag.

   
6. Klicken Sie zum Aktualisieren der Firestore-Seite in der Cloud Console auf 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:

bookshelf/books/firestore.js

Auf GitHub ansehen

const {Firestore} = require('@google-cloud/firestore');

const db = new Firestore();
const collection = 'Book';

async function read(id) {
  const doc = await db.collection(collection).doc(id).get();

  if (!doc.exists) {
    throw new Error('No such document!');
  }
  return doc.data();
}

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.

1. Wechseln Sie in der Cloud Console zum Cloud Storage-Browser.

   Zum Cloud Storage-Browser

2. Klicken Sie auf Bucket erstellen.
3. 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 Name YOUR_PROJECT_ID_bucket lautet. Der Name unterliegt den Anforderungen für Bucket-Namen. Bei allen übrigen Feldern können die Standardwerte übernommen werden.
4. Klicken Sie auf Erstellen.
5. 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.
6. Klicken Sie auf Buch bearbeiten und wählen Sie ein Bild als Buchcover zum Hochladen aus. Sie können beispielsweise dieses urheberrechtsfreie Bild verwenden:
   
7. 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.

bookshelf/lib/images.js

Auf GitHub ansehen

const {Storage} = require('@google-cloud/storage');

const storage = new Storage();
const bucket = storage.bucket(CLOUD_BUCKET);

Hinweis: Sie können den Bucket-Namen ändern, indem Sie die Variable CLOUD_BUCKET im vorherigen Code unter einem anderen Namen eingeben und die Anwendung durch Ausführen des Befehls gcloud app deploy noch einmal bereitstellen

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

Cloud Console

1. Rufen Sie im Browser die /logs-URL in Ihrer Anwendung auf:

   https://PROJECT_ID.REGION_ID.r.appspot.com/logs

   Dadurch wird ein benutzerdefinierter Eintrag an Cloud Logging gesendet. Der Eintrag hat einen Logschweregrad von NOTICE und enthält die Nachricht „Hey, you triggered a custom log entry. Good job!“.

2. Rufen Sie die Loganzeige auf. Darin können Sie die Anwendung in Echtzeit überwachen. Wenn etwas schiefgeht, ist dies einer Ihrer ersten Anlaufpunkte.
   
3. Wählen Sie in der Ressourcen-Drop-down-Liste GAE Application aus.
4. Wählen Sie in der Logs-Drop-down-Liste Alle Logs aus.

   Es gibt eine Zeile für den benutzerdefinierten Logeintrag.

   

gcloud

1. Überwachen Sie die Anwendungslogs in Ihrem Terminalfenster über die Google Cloud-Befehlszeile, indem Sie auf neue Logeinträge achten:

   gcloud app logs tail

2. Rufen Sie im Browser die /logs-URL in Ihrer Anwendung auf:

   https://PROJECT_ID.REGION_ID.r.appspot.com/logs

   Dadurch wird ein benutzerdefinierter Eintrag an Cloud Logging gesendet. Der Eintrag hat einen Logschweregrad von NOTICE und enthält die Nachricht „Hey, you triggered a custom log entry. Good job!“.

   In der Ausgabe des gcloud-Befehls ist der neue Logeintrag zu sehen:

   Waiting for new log entries...
   2019-03-27 22:17:01 default[20190327t151430]  "Hey, you triggered a custom log entry. Good job!"

Fehler mithilfe von Error Reporting überwachen

1. 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.
2. Rufen Sie im Browser die URL /errors in der Anwendung auf.
   

   https://PROJECT_ID.REGION_ID.r.appspot.com/errors

   Dadurch wird eine neue Testausnahme erzeugt und an die Operations-Suite von Google Cloud gesendet.

3. Kehren Sie in der Cloud Console zur Seite Error Reporting zurück. Nach kurzer Zeit ist der neue Fehler zu sehen. Klicken Sie auf Automatische Aktualisierung, damit Sie die Seite nicht manuell aktualisieren müssen.

   

Hinweis: Application Performance Management enthält viele Tools für das Debuggen und Monitoring von Anwendungen. Weitere Informationen dazu finden Sie in den Anleitungen.

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

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Nächste Schritte

• Anwendung in Google Kubernetes Engine bereitstellen
• Anwendung in Compute Engine bereitstellen
• Sitzungen mit Cloud Firestore verarbeiten