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. Sie können die Datei direkt bearbeiten.

Um Ihren Dienst lokal auszuführen, geben Sie Ihre Konfiguration an:

  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 dann die Quelle an.
    • (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, auf dem der HTTP-Server überwacht werden 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 erstellten Cloud Run-Konfiguration die Ü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 Automatisch neu erstellen und bei Änderungen 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 die folgenden Befehle zu verwenden:

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

  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. Mit der Secret Manager-Integration von Cloud Code können Sie diese Secrets sicher 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: Wartet auf Änderungen im Arbeitsbereich und führt den Dienst noch einmal aus. Standardmäßig „true“.

    Im folgenden Beispiel ist für die Smartwatch true festgelegt:

    "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: Geben Sie Debug-Einstellungen an, z. B. die Zuordnung des Remotepfads, um dem Pfad des Remote-Containers einen lokalen Pfad zuzuordnen.

    Das folgende Beispiel zeigt einen Debug-Abschnitt, der den Speicherort der Quelldateien angibt:

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

Support anfragen

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