Cloud Run-Dienst lokal entwickeln

Bevor Sie einen Dienst in Cloud Run bereitstellen, können Sie ihn lokal mit einem Cloud Run-Emulator entwickeln.

Dienst für die Entwicklung konfigurieren

So führen Sie Ihren Dienst lokal aus:

  1. Öffnen Sie die Befehlspalette (drücken Sie Ctrl/Cmd+Shift+P) und führen Sie dann den Befehl Run on Cloud Run Emulator aus.
  2. Legen Sie im Dialogfeld "Run/Debug on Cloud Run Emulator" die Spezifikationen für Ihre Konfiguration fest.

    Cloud Run: Lokale Benutzeroberfläche ausführen/Fehlerbehebung

Optional: Konfiguration anpassen

Zusätzlich zu den obigen Einstellungen können Sie im Abschnitt "Erweiterte Einstellungen" erweiterte Einstellungen wie für ein Dienstkonto oder Umgebungsvariablen angeben.

Umgebungsvariablen

Die folgenden Umgebungsvariablen werden den ausgeführten Containern automatisch hinzugefügt:

Name Beschreibung Beispiel
PORT Der Port, den Ihr HTTP-Server beobachten soll. 8080
K_SERVICE Der Name des ausgeführten Cloud Run-Dienstes. hello-world
K_REVISION Der Name der ausgeführten Cloud Run-Überarbeitung. hello-world.1
K_CONFIGURATION Der Name der Cloud Run-Konfiguration, mit der die Überarbeitung erstellt wurde. hello-world

Dienst lokal ausführen

  1. Nachdem Sie die gewünschten Einstellungen vorgenommen haben, führen Sie den Dienst aus. Klicken Sie dazu auf Run (Ausführen).
  2. Überwachen Sie den Status der Bereitstellung im Ausgabefenster.

    Wenn die Bereitstellung abgeschlossen ist, können Sie den ausgeführten Dienst aufrufen. Dazu öffnen Sie die URL, die im Ausgabefenster angezeigt wird.

  3. Wenn Sie ausführliche Logs aufrufen möchten, wechseln Sie im Ausgabefenster zur detaillierten Cloud Run-Ansicht.

    Ausgabebereich mit der Option hellohello-world-5 – Detailed“ (Ausführliche Informationen) aus dem Drop-down-Menü der Ausgabekanäle

  4. Nach Abschluss der Sitzung stehen Ihnen zusätzliche Kontextmenüoptionen zur Überwachung Ihrer Anwendung und ihrer Ressourcen mithilfe der Cloud Code-Statusleiste zur Verfügung, darunter:

    • Bereitstellungslogs öffnen: Mit der Cloud Code-Loganzeige können Sie die Anwendungslogs einer bestimmten Bereitstellung öffnen
    • Dienst-URL öffnen: Mit dieser Option können Sie die URL des Anwendungsdienstes eines bestimmten Dienstes in einem Webbrowser öffnen.
    • Wiedergabemodus aktivieren/deaktivieren:Wechseln Sie den Wiedergabemodus für die aktuelle Sitzung. Standardmäßig überwacht Cloud Code das Dateisystem kontinuierlich auf Änderungen an Ihren Dateien, z. B. Kubernetes-Konfiguration oder -Code, erstellt die Container neu und stellt die Anwendung im Cluster neu bereit, sodass { 101}Änderungen werden nahezu in Echtzeit wiedergegeben.
  5. Sie können die Bereitstellung beenden, indem Sie in der Aktionsleiste der aktuellen Bereitstellung auf die Schaltfläche Beenden klicken.

    Aktionsleiste für die Cloud Run-Bereitstellung

Secrets speichern

Wenn Ihr Code potenziell vertrauliche Daten wie API-Schlüssel, Passwörter und Zertifikate enthält, sollten Sie diese als Secrets speichern. Mit Cloud Code können Sie diese Secrets sicher in Secret Manager speichern und sie bei Bedarf programmatisch abrufen. Ausführliche Informationen zum Erstellen und Verwalten von Secrets mit Cloud Code finden Sie in der Anleitung zu Secret Manager.

Vorhandene Konfiguration von "launch.json" anpassen

Um die Ausführung Ihres Diensts zu konfigurieren, können Sie skaffold.yaml anpassen und die folgenden Felder in Ihrem .vscode/launch.json angeben:

  • watch: Prüft im Ausführungsmodus auf Änderungen im Arbeitsbereich und führt den Dienst noch einmal aus. Sofern der Wert nicht explizit auf "false" festgelegt wird, ist standardmäßig "true" eingestellt.
  • Build: Geben Sie den Builder (Docker, Buildpacks) an, mit dem Sie Ihre Images erstellen möchten.
  • Image: Geben Sie den Namen des Images an, das Sie verwenden möchten.
  • Service: Geben Sie den Cloud Run-Dienst an, den Sie verwenden möchten.
  • Debug: Geben Sie bevorzugte Fehlerbehebungseinstellungen an, z. B. die Zuordnung des Remotepfads, um dem Pfad des Remote-Containers einen lokalen Pfad zuzuordnen.

Support

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