Kurzanleitung für Remote-Entwicklung

Auf dieser Seite wird beschrieben, wie Sie für einen schnellen Einstieg in Cloud Code die Remote-Entwicklungsumgebung in Cloud Shell nutzen können.

In dieser Kurzanleitung überspringen Sie mit einem Klick das Einrichten und Klonen eines Projekts in den Arbeitsbereich für die Remote-Entwicklung. Sie erstellen einen Cluster, führen eine Kubernetes-Anwendung auf diesem Cluster aus, beheben Fehler im ausgeführten Code, sehen sich Logs aus Ihrer Live-Anwendung an und verbinden außerdem ein Terminal mit dem ausgeführten Container.

Vorbereitung

Für den Zugriff auf Cloud Shell, die Remote-Entwicklungsumgebung in Google Cloud, die Sie für diese Kurzanleitung verwenden, müssen Sie ein GCP-Projekt erstellen und die Abrechnung aktivieren.

Außerdem muss Folgendes auf Ihrem Computer installiert sein:

Cloud Code starten

Nachdem Sie Visual Studio Code und die Erweiterung Remote – SSH installiert haben, klicken Sie unten auf die Schaltfläche "Mit Cloud Code öffnen", um Visual Studio Code zu öffnen, das mit einer Remote-Entwicklungsumgebung in Cloud Shell verbunden ist. Diese Umgebung enthält alle Tools, die Sie zum Entwickeln von Kubernetes-Anwendungen benötigen.

Wenn Sie auf die Schaltfläche "Mit Cloud Code öffnen" klicken, wird VS Code gestartet und klont automatisch ein Projekt in Ihren Arbeitsbereich für die Remote-Entwicklung. Wenn Sie die benötigten Komponenten noch nicht eingerichtet haben, werden Sie jetzt aufgefordert, sie zu installieren.

Wählen Sie die bevorzugte Sprache für das geklonte Projekt aus und klicken Sie auf die Schaltfläche "Mit Cloud Code öffnen", um im Arbeitsbereich mit der Remote-Entwicklung zu beginnen:

Google Kubernetes Engine-Cluster erstellen

So erstellen Sie einen GKE-Cluster:

  1. Rufen Sie in der Cloud Code-Ansicht Kubernetes Explorer-Symbol den Google Kubernetes Engine Explorer auf. Klicken Sie dazu links in der VS Code-Aktivitätsleiste auf das entsprechende Symbol.
  2. Authentifizieren Sie sich mit dem Cloud SDK, indem Sie auf "Click here to log in to Google Cloud SDK" klicken.
  3. Klicken Sie zum Erstellen eines neuen GKE-Clusters im Kopfbereich des Google Kubernetes Engine Explorers auf die Schaltfläche "+" (Plussymbol), die bei Mouseover verfügbar wird.
  4. Achten Sie darauf, den Cluster in Ihrem Standardprojekt zu erstellen.
  5. Füllen Sie die Felder im Cluster-Erstellungsassistenten aus und klicken Sie auf "Cluster erstellen".

    In diesem Beispiel wird die Projekt-ID über die Standardschaltfläche "Projekt-ID" festgelegt. Die Zone wird als "us-central1-a" und der Clustername als "test" angegeben.

    Das Erstellen des Clusters dauert einige Minuten. Nach der Erstellung wird Ihr Cluster in der GKE Explorer-Ansicht Kubernetes Explorer-Symbol aufgeführt.

    Neuen Cluster mit dem GKE Explorer erstellen

Anwendung ausführen

Sie können Ihre Anwendung jetzt ausführen und live ansehen. Darüber hinaus beobachtet Cloud Code Ihr Dateisystem auf Änderungen, sodass Sie Ihre Anwendung nahezu in Echtzeit bearbeiten und noch einmal ausführen können.

So führen Sie Ihre Anwendung aus:

  1. Verwenden Sie die Cloud Code-Statusleiste und wählen Sie Run on Kubernetes aus.
  2. Bestätigen Sie, ob Sie den aktuellen Clusterkontext verwenden oder zu einem bevorzugten Kontext wechseln möchten.
  3. Je nach ausgewähltem Kontext werden Sie möglicherweise aufgefordert, eine Image-Registry auszuwählen, in die die Images übertragen werden sollen.
  4. Ein Ausgabefenster wird angezeigt, in dem Sie den Fortschritt Ihrer ausgeführten Anwendung verfolgen können. Außerdem sehen Sie in der Terminalausgabe einen Livestream der Logs der ausgeführten Pods.
  5. Nach erfolgreicher Ausführung wird im Ausgabefenster eine IP-Adresse angezeigt. Drücken Sie Strg/Befehlstaste und klicken Sie auf die verknüpfte Adresse, um auf Ihre Anwendung zuzugreifen.

    Die

Tipps zur Fehlerbehebung

  1. Wenn Sie einen bereits vorhandenen Cluster verwenden, führen Sie gcloud container clusters get-credentials ${CLUSTER} --zone=${ZONE} aus, um Clusteranmeldedaten abzurufen. Dadurch wird Ihr Cluster auch zu kubectl hinzugefügt.

    Alternativ können Sie den GKE Explorer aufrufen (als Bereich, der über den Kubernetes Explorer in der Cloud Code-Ansicht Kubernetes Explorer-Symbol zugänglich ist). Klicken Sie mit der rechten Maustaste auf den gewünschten Cluster und wählen Sie "Set as Active Cluster" aus.

Anwendung debuggen

So beheben Sie Fehler in Ihrer Anwendung:

  1. Wählen Sie in der Cloud Code-Statusleiste Debug on Kubernetes aus.
  2. Wenn Sie dazu aufgefordert werden, bestätigen Sie, ob Sie den aktuellen Clusterkontext verwenden oder zu einem bevorzugten Kontext wechseln möchten.

    Cloud Code verwendet die Konfigurationen "cloudcode.kubernetes" in Ihrer Datei ".vscode/launch.json", um Ihre Anwendung auszuführen und eine Debugger-Sitzung an diese anzuhängen.

  3. Cloud Code erstellt dann Ihre Container, verschiebt sie in die Registry, wendet Kubernetes-Konfigurationen auf den Cluster an und gibt die IP-Adresse zurück, mit der Sie Ihre Live-Anwendung durchsuchen können.

  4. Vor dem Anhängen der Debugger-Sitzung werden Sie aufgefordert, das Verzeichnis im Remote-Container zu bestätigen oder einzugeben, in dem sich das Programm befindet, für das das Debugging durchgeführt werden soll (oder drücken Sie die ESC-Taste, um das Debuggen des Containers zu überspringen).

  5. Klicken Sie in den Editorrand von "app.js", um einen Haltepunkt hinzuzufügen.

    Rot ausgefüllte Kreise kennzeichnen aktive Haltepunkte, während graue leere Kreise deaktivierte Haltepunkte angeben. Für eine genauere Steuerung der Haltepunkte können Sie den Abschnitt "Breakpoints" in der Fehlerbehebungsansicht von VS Code verwenden.

    Abschnitt

    Wenn Sie eine neue Anfrage an Ihre Anwendung senden, wird sie in der gewünschten Zeile pausiert.

  6. (Optional) In der Debugging-Seitenleiste können Sie Variablen und Stack-Informationen prüfen.

    Verwenden Sie die Debug Console im Debugger im unteren Bereich, um mit der Fehlerbehebungssitzung zu interagieren.

    Eine Anwendung, die am Haltepunkt angehalten wurde und deren Bereiche für Variablen und den Aufrufstack mit entsprechenden Werten ausgefüllt wurden

Logs ansehen

Sie können einen Livestream der Logs aus ausgeführten Pods in der Terminalausgabe Ihrer ausgeführten Anwendung sehen. Außerdem haben Sie die Möglichkeit, Logs mit der Loganzeige anzusehen, die in Cloud Code enthalten ist.

So rufen Sie Logs auf:

  1. Starten Sie die Loganzeige. Geben Sie dazu Cloud Code: View Logs aus der Befehlspalette ein (aufrufbar über Strg/Befehlstaste + Umschalt + P oder über das Menü "Manage", das mit einem Zahnradsymbol Verwaltungssymbol gekennzeichnet ist).
  2. Suchen Sie nach der ausgeführten Anwendung, in diesem Fall "nodejs-hello-world", um Logs aus dem Bereitstellungsfeld im Suchfeld der Loganzeige anzeigen zu lassen.

    Logs dadurch ansehen, dass das Bereitstellungsfeld im Suchfeld der Loganzeige auf

Bonus: Terminal in Ihrem Container öffnen

Wenn Sie außerdem ein Terminal in Ihrem Container öffnen möchten, gehen Sie so vor:

  1. Rufen Sie den Kubernetes Explorer auf.
  2. Wählen Sie den Cluster aus und wählen Sie im Abschnitt "Pods" den Pod aus, zu dem Sie eine Verbindung herstellen möchten.
  3. Erweitern Sie unter dem angegebenen Pod den Abschnitt "Containers" und klicken Sie mit der rechten Maustaste auf den Container, in dem Sie ein Terminal öffnen möchten.
  4. Wählen Sie Get Terminal aus.

    Dadurch wird ein Terminal gestartet. Sie haben jetzt Zugriff auf eine Shell im ausgeführten Container.

    Terminal für den angegebenen Pod öffnen

Bereinigen

Sobald Sie Ihre Anwendung beenden, werden alle während der Ausführung bereitgestellten Kubernetes-Ressourcen automatisch gelöscht.

Damit Ihr Konto jedoch nicht für andere in dieser Kurzanleitung verwendete Ressourcen belastet wird, müssen Sie den von Ihnen erstellten Cluster und das Projekt löschen.

Wenn Sie Google Cloud verwenden und nur Ihren Cluster löschen möchten, haben Sie folgende Möglichkeiten:

  • Klicken Sie im Kubernetes Explorer in der Cloud Code-Ansicht Kubernetes Explorer-Symbol mit der rechten Maustaste auf den Cluster, den Sie aus dem Google Kubernetes Engine Explorer-Bereich löschen möchten, und wählen Sie "Delete cluster" aus.

So löschen Sie Ihr Projekt und die zugehörigen Ressourcen, einschließlich der Cluster:

  • Rufen Sie in der Cloud Console die Seite "Projekte" auf:

    Zur Seite "Projekte"

  • Wählen Sie das Projekt aus, das Sie für diesen Schnellstart erstellt haben, und klicken Sie auf das Papierkorbsymbol, um es zu löschen.

    Das Projekt wird beendet und der Löschvorgang geplant.

Weitere Informationen