Cloud Run-Dienst lokal in Cloud Code for VS Code 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

Wenn Sie keine .vscode/launch.json-Datei definiert haben, können Sie im Dialogfeld Ausführen/Fehlerbehebung im Cloud Run-Emulator die Ausführung konfigurieren und die Einstellungen dann in .vscode/launch.json speichern. Wenn Sie eine .vscode/launch.json-Datei konfiguriert haben, können Sie sie direkt bearbeiten.

Geben Sie Ihre Konfiguration an, um Ihren Dienst lokal auszuführen:

  1. Öffnen Sie die Befehlspalette. Drücken Sie dazu Ctrl/Cmd + Shift + P oder klicken Sie auf Ansicht > Befehlspalette) und führen Sie dann den Befehl Run on Cloud Run Emulator aus.
  2. Legen Sie im Dialogfeld „Ausführen/Debuggen im Cloud Run-Emulator“ die Spezifikationen für Ihre Konfiguration fest:

    • Für Cloud Run sind nur lokal installierte Build-Tools verfügbar Emulator
    • Wählen Sie Docker oder Buildpacks als Builder aus und geben Sie den Quelle
    • (Optional) Hier können Sie Umgebungsvariablen angeben, die an die laufende Maximieren Sie Erweiterte Build-Einstellungen und klicken Sie, um Container anzugeben. Schlüssel/Wert-Paare.
      Name Beschreibung Beispiel
      Port Der Port, den der HTTP-Server überwacht. 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 erstellten Cloud Run-Konfiguration der Überarbeitung. hello-world
    • (Optional) Um Cloud SQL-Verbindungen anzugeben, maximieren Sie Erweiterte Diensteinstellungen auf, klicken Sie auf Verbindungen und geben Sie eine Option an. Cloud SQL-Verbindung pro Zeile.
    • Optional: Klicken Sie das Kästchen Dienst von anderen Geräten im lokalen Netzwerk zugänglich machen an.
    • Optional: Wenn Sie Ihren Dienst nur manuell neu erstellen und ausführen möchten, anstatt ihn bei Änderungen automatisch neu zu erstellen und auszuführen, entfernen Sie das Häkchen bei Bei Änderungen automatisch neu erstellen und noch einmal ausführen.

Dienst lokal ausführen

  1. Nachdem Sie Ihre bevorzugten Einstellungen festgelegt haben, führen Sie den Dienst aus, indem Sie auf Ausführen klicken.

  2. Wenn Sie dazu aufgefordert werden, authentifizieren Sie Ihre Anmeldedaten, um eine Anwendung lokal.

  3. Überwachen Sie den Status der Bereitstellung im Ausgabefenster.

    Nach Abschluss der Bereitstellung können Sie den ausgeführten Dienst anzeigen, indem Sie die im Ausgabefenster angezeigte URL öffnen.

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

    Ausgabebereich mit „hello-world-5“ – Detaillierte Auswahl aus dem Drop-down-Menü für den Ausgabekanal

  5. Klicken Sie nach Abschluss der Sitzung mit der rechten Maustaste, um folgende Befehle auszuführen:

    • View Logs (Logs ansehen): Öffnen Sie die Anwendungslogs einer bestimmten Bereitstellung mit dem Cloud Code-Log-Explorer
    • Open URL (URL öffnen): Die Anwendungsdienst-URL einer bestimmten in einem Webbrowser.
  6. Wenn du den Uhrmodus in der Startkonfiguration deaktiviert hast und Änderungen an Ihrer Anwendung vornehmen und sie neu erstellen und bereitstellen, klicken Sie auf die Cloud Code-Statusleiste und dann auf Aktivieren Sie den Smartwatch-Modus.

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

Secrets speichern

Wenn Ihr Code potenziell sensible Daten wie API-Schlüssel, Passwörter und und als Secrets speichern, können Sie sie absichern. Die Mit der Einbindung von Cloud Code Secret Manager diese Secrets speichern und programmatisch abrufen. Ausführliche Informationen können Sie Secrets mit Cloud Code erstellen und verwalten: den Leitfaden zu Secret Manager.

Vorhandene Konfiguration von "launch.json" anpassen

Das Cloud Code-Plug-in aktualisiert die launch.json-Konfigurationsdatei automatisch, wenn Sie eine Ausführungsaktion auswählen. Wenn Sie die Ausführung des Diensts weiter anpassen möchten, können Sie die folgenden Felder in Ihrer .vscode/launch.json-Datei angeben:

  • watch: Beobachtet Änderungen im Arbeitsbereich und Wiederholungen für den Dienst. Standardmäßig „true“.

    Im folgenden Beispiel ist die Smartwatch auf true eingestellt:

    "watch": true,
    
  • build: Builder angeben (Docker, jibMaven, jibGradle oder Buildpacks) mit denen Sie Ihre Bilder erstellen können.

    Das folgende Beispiel zeigt einen Docker-Builder:

    "build": {
      "docker": {
        "path": "Dockerfile"
      }
    },
    

    Das folgende Beispiel zeigt einen Buildpack-Builder:

    "build": {
      "buildpacks": {
        "path": "src/requirements.txt",
        "builder": "gcr.io/buildpacks/builder:v1"
      }
    },
    
  • image: Geben Sie den Namen des Images an, das verwendet werden soll.

    Das folgende Beispiel zeigt, wie Sie einen Image-Namen angeben:

      "image": "hello-world",
    
  • service: Geben Sie den zu verwendenden Cloud Run-Dienst an.

    Das folgende Beispiel zeigt, wie ein Dienstname, ein Port und eine Ressource angegeben werden Limits:

    "service": {
      "name": "hello-world",
      "containerPort": 8080,
      "resources": {
        "limits": {
          "memory": "256Mi"
        }
      }
    },
    
  • debug: Legen Sie Einstellungen zur Fehlerbehebung fest, z. B. die Remote-Pfadzuordnung, um eine lokale Pfad zu einem Pfad im Remote-Container.

    Im folgenden Beispiel sehen Sie einen Debug-Bereich, Standort:

    "debug": {
      "sourceFileMap": {
        "${workspaceFolder}": "/app"
      }
    }
    

Support erhalten

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