Fehler in einem Cloud Run-Dienst in Cloud Code für VS Code beheben

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Mit Cloud Code for VS Code können Sie Anwendungen, die in Cloud Run bereitgestellt wurden, mithilfe von skaffold debug ganz einfach debuggen. Ausführliche Informationen zum Skaffold-Debugging finden Sie unter Debugging mit Skaffold.

Eine manuelle Einrichtung wie die Portweiterleitung oder das Einfügen sprachspezifischer Debug-Argumente ist nicht erforderlich. Für die Fehlerbehebung ist eine Cloud Code-fähige Cloud Run-Anwendung erforderlich, die eine skaffold.yaml-Konfigurationsdatei und eine launch.json-Datei vom Typ cloudcode.cloudrun enthält.

Fehler in Ihrem Cloud Run-Dienst beheben

So beheben Sie Fehler in Ihrer Dienst:

  1. Öffnen Sie die Befehlspalette, indem Sie Ctrl/Cmd+Shift+P drücken oder auf Ansicht > Befehlspalette klicken, um den Dienst auszuführen und eine Debugger-Sitzung anzuhängen. Führen Sie dann den Befehl Debug on Cloud Run Emulator aus.

  2. Legen Sie im Dialogfeld „Ausführen/Debuggen im Cloud Run-Emulator“ die Spezifikationen für Ihre Konfiguration fest:

    • Wählen Sie Docker oder Buildpacks als Builder aus und geben Sie dann das Dockerfile oder Buildpack an.
    • Optional: Wenn Sie ein Dockerfile-Ziel angeben oder Build-Argumente angeben möchten, klicken Sie auf Erweiterte Build-Einstellungen anzeigen und geben Sie dann das Ziel oder die Argumente an.
    • Optional: Wenn Sie für jede Containerinstanz einen benutzerdefinierten Dienstnamen, eine Container-Image-URL, einen Containerport, eine zu verwendende Identität, die Anzahl der dedizierten CPUs oder die Größe des Arbeitsspeichers angeben möchten, klicken Sie auf Erweiterte Diensteinstellungen anzeigen und geben Sie dann die Werte an.
    • Optional: Wenn Sie Umgebungsvariablen angeben möchten, klicken Sie auf Erweiterte Diensteinstellungen anzeigen, dann auf Umgebungsvariablen und geben Sie dann die Werte an.
    • Optional: Klicken Sie zum Angeben von Cloud SQL-Verbindungen auf Verbindungen und geben Sie dann eine Verbindung pro Zeile an.
    • Optional: Wenn VS Code nach dem Speichern einer Änderung an Ihrem Code eine Debugging-Sitzung neu einrichten soll, klicken Sie das Kästchen Build on rebuild and re-run on changes an.

    Wenn Sie die Ausführung Ihres Dienstes weiter anpassen möchten, können Sie Ihre launch.json-Datei direkt bearbeiten.

  3. Klicken Sie auf Fehlerbehebung, um mit der Fehlerbehebung Ihres Dienstes zu beginnen.

  4. Bestätigen oder geben Sie für jeden debugfähigen Container in Ihrem Dienst das Verzeichnis im Remote-Container ein, in dem sich das Programm befindet, für das das Debugging durchgeführt werden soll.

    Alternativ können Sie ESC drücken, um das Debuggen eines Containers zu überspringen.

    Remote-Root-Aufforderung

    Cloud Code fügt für jeden debugfähigen Container in dem Dienst eine Debug-Sitzung hinzu.

    Wenn Sie eine Änderung an Ihrer Anwendung speichern, stellt Cloud Code Ihre Anwendung standardmäßig noch einmal bereit und richtet eine neue Debug-Sitzung ein. Sie können dieses Feature in der Startkonfiguration Ihres Projekts mit dem Flag watch ein- oder ausschalten.

  5. Klicken Sie zum Hinzufügen eines Haltepunkts in den Editorrand der Datei, für die das Debugging ausgeführt wird.

    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 „Haltepunkte“ in der Fehlerbehebungsansicht von VS Code verwenden.

    Abschnitt "Breakpoints" im linken Bereich der Fehlerbehebungsansicht, über die Haltepunkte hinzugefügt, entfernt und deaktiviert werden können

    Wenn Sie eine neue Anfrage an Ihren Dienst senden, wird er in der von Ihnen angegebenen Zeile pausiert.

  6. Nach dem Ende der Sitzung klicken Sie mit der rechten Maustaste, um die folgenden Befehle zu verwenden:

    • Logs ansehen:Öffnen Sie mit dem Cloud Code Log-Explorer die Anwendungslogs einer bestimmten Bereitstellung
    • URL öffnen:Anwendungs-URL eines bestimmten Dienstes in einem Webbrowser öffnen
  7. Wenn Sie den Smartwatchmodus in der Startkonfiguration deaktiviert haben und Änderungen an der Anwendung vornehmen und die Anwendung neu erstellen und bereitstellen möchten, klicken Sie auf die Cloud Code-Statusleiste und dann auf Smartwatchmodus aktivieren.

  8. 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 Debugging-Sitzung zu interagieren.

  9. Klicken Sie in der Aktionsleiste Ihrer aktuellen Bereitstellung auf die Schaltfläche Beenden, um die Bereitstellung zu beenden.

    Aktionsleiste für die Cloud Run-Bereitstellung

Konfigurationsdetails

Cloud Code verarbeitet die folgenden sprachspezifischen Konfigurationsdetails:

Node.js

Neuschreiben des Einstiegspunkts, der aufgerufen werden soll:

node --inspect=localhost:9229

Python

Installieren Sie das Modul ptvsd mit einem Init-Container und schreiben Sie den Einstiegspunkt neu:

python -m ptvsd --host localhost --port 5678

Go

Installieren des dlv-Debuggers mit einem Init-Container und Umschreiben des Einstiegspunkts, sodass die gestartete Fehlerbehebungssitzung nur mit einem Fehlerbehebungsserver (im monitorlosen Modus) den Debug-Prozess beim Start fortsetzt, mehrere Client-Verbindungen akzeptiert und unter localhost:56268 empfängt:

dlv exec --headless --continue --accept-multiclient --listen=localhost:56268 --api-version=2, <app> --

Java

Hinzufügen einer Umgebung JAVA_TOOLS_OPTIONS mit der entsprechenden Java Debug Wire Protocol (JDWP)-Konfiguration, sodass der JDWP-Debugging-Agent eine Socket-Verbindung auf Port 5005 überwacht und die VM mit der Ausführung beginnen kann, bevor der Debugger angehängt wird:

jdwp=transport=dt_socket,server=y,suspend=n,address=5005,quiet=y

.NET

.NET Core-Anwendungen sind so konfiguriert, dass sie zusammen mit vsdbg für VS Code bereitgestellt werden.

Bei Problemen mit der automatischen Konfiguration finden Sie unter Detaillierte Konfiguration des Debuggers und Einrichtung Hilfe zur Fehlerbehebung.

Support

Wenn Sie uns Feedback geben möchten, können Sie Probleme auf GitHub melden oder eine Frage in Stack Overflow stellen.