Kurzanleitung für Node.js in der Standardumgebung

Kurzanleitung für Node.js in der 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. Bei Anwendungen, die nach Februar 2020 erstellt wurden, ist REGION_ID.r in den App Engine-URLs enthalten. Bei Anwendungen, die vor diesem Datum erstellt wurden, ist die Regions-ID in der URL optional.

Hier finden Sie weitere Informationen zu Regions-IDs.

OK

Python 2.7/3 |Java 8/11 |PHP 5/7 |Ruby |Go 1.11/1.12+ |Node.js

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

Ist App Engine die richtige Computing-Option für Sie? Weitere Optionen zum Hosten Ihrer Anwendung in Google Cloud

Kosten

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

Hinweis

1. 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.

2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

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

4. Cloud Build API aktivieren.

   Aktivieren Sie die API

5. Installieren Sie die Google Cloud CLI.

6. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

   gcloud init

7. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

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

9. Cloud Build API aktivieren.

   Aktivieren Sie die API

10. Installieren Sie die Google Cloud CLI.

11. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

    gcloud init

Zusätzliche Voraussetzungen

1. 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.

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

2. Installieren Sie folgende Abhängigkeiten:

   • Git herunterladen und installieren
   • Ihre Umgebung für die Node.js-Entwicklung vorbereiten

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 Nutzung von Diensten über mehrere Standorte kann die Latenz der Anwendung sowie die Preise beeinflussen.

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

Hinweis: Zwei Standorte, die in App Engine-Befehlen und in der Google Cloud Console europe-west und us-central heißen, werden in der Google-Dokumentation als europe-west1 bzw. us-central1 bezeichnet.

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

• Führen Sie den Befehl gcloud app describe aus:

• Öffnen Sie das App Engine-Dashboard in der Cloud Console. Die Region wird oben auf der Seite angezeigt.

OK

Diese Kurzanleitung umfasst eine einfache Node.js-Anwendung, die mit dem Express.js-Framework geschrieben wurde.

Wichtig: Führen Sie mithilfe des Befehls npm install -g npm ein Upgrade auf die neueste Version des Node.js-Paketmanagers (npm) durch, um unter Windows optimal arbeiten zu können. Die neueste Version von npm installiert Abhängigkeiten in einer flachen Verzeichnisstruktur. Darum besteht kaum die Gefahr, dass Installationen mit der maximalen Pfadlänge von 255 Zeichen unter Windows in Konflikt geraten. Wenn Sie weiterhin eine ältere Version von npm verwenden möchten, können Sie den Pfad verkürzen. Verschieben Sie dazu Ihr Projekt in das Stammverzeichnis des Laufwerks, z. B. nach C:\.

Beispielcode herunterladen

Verschaffen Sie sich mit unserer einfachen Hello World-App einen schnellen Überblick über die Bereitstellung eines Webdienstes in App Engine. Führen Sie die folgenden Schritte aus, um den Code in Ihre Entwicklungsumgebung herunterzuladen.

1. Laden Sie das Beispiel-App-Repository Node.js herunter:

   Cloud Shell

   Öffnen Sie das Repository in Cloud Shell:

   

   Lokaler Rechner

   Laden Sie das Repository als ZIP-Datei herunter und extrahieren Sie es.

   Alternativ können Sie das Repository mit git klonen:

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

2. Wechseln Sie in das Verzeichnis, das die Hello World-App enthält:

   cd nodejs-docs-samples/appengine/hello-world/standard
   

Hello World lokal ausführen

1. Installieren Sie Abhängigkeiten für das Projekt:

   npm install
   

2. Starten Sie den HTTP-Server:

   npm start
   

3. Sehen Sie sich die App in Ihrem Webbrowser an:

   Cloud Shell

   Klicken Sie in der Symbolleiste von Cloud Shell auf Webvorschau und wählen Sie Vorschau auf Port 8080 aus.

   Lokaler Rechner

   Öffnen Sie http://localhost:8080 in Ihrem Webbrowser.

   Auf der Seite wird die Nachricht „Hello, world!“ angezeigt.

4. Beenden Sie den HTTP-Server, indem Sie im Terminalfenster Strg+C drücken.

Hello-World-Anwendung in App Engine bereitstellen und ausführen

1. Stellen Sie die Hello World-Anwendung in App Engine bereit. Führen Sie dazu den folgenden Befehl im Verzeichnis hello-world/standard aus:

   gcloud app deploy
   

2. Sehen Sie sich die Live-Anwendung unter https://PROJECT_ID.REGION_ID.r.appspot.com an:

   gcloud app browse
   

Die Nachricht „Hello, world!“ wird nun von einem Webserver bereitgestellt, der in einer App Engine-Instanz ausgeführt wird.

Das wars! Sie haben erfolgreich einen Node.js-Webdienst in App Engine bereitgestellt.

Bereinigen

Wenn Sie weitere Informationen zu App Engine erhalten möchten, können Sie Ihr Cloud-Projekt beibehalten und den Schritten unter Anwendung erstellen folgen.

Alternativ können Sie Ihr Cloud-Projekt löschen, um die Abrechnung für alle in diesem Projekt verwendeten Ressourcen zu beenden.

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.
1. Wechseln Sie in der Google 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

Sie haben nun einen Webdienst in App Engine bereitgestellt. Unter Anwendung erstellen finden Sie eine schrittweise Anleitung zu Node.js in App Engine.

Weitere Informationen zur Node.js-Laufzeit in der App Engine-Standardumgebung finden Sie unter Node.js-Laufzeit.