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 Im Cloud Run-Emulator ausführen/debuggen die Einstellungen für den Start konfigurieren. Diese werden dann in .vscode/launch.json gespeichert. Wenn Sie eine .vscode/launch.json-Datei konfiguriert haben, können Sie sie direkt bearbeiten.
Geben Sie die Konfiguration an, um den Dienst lokal auszuführen:
- Öffnen Sie die Befehlspalette (über
Ctrl/Cmd+Shift+Poder Ansicht > Befehlspalette) und führen Sie dann den Befehl Im Cloud Run-Emulator ausführen aus. Legen Sie im Dialogfeld „Ausführen/Debuggen im Cloud Run-Emulator“ die Spezifikationen für Ihre Konfiguration fest:
- Für den Cloud Run-Emulator sind nur lokal installierte Build-Tools verfügbar.
- Wählen Sie Docker oder Buildpacks als Builder aus und geben Sie dann die Quelle an.
- Optional: Wenn Sie Umgebungsvariablen angeben möchten, die an die ausgeführten Container übergeben werden sollen, maximieren Sie Erweiterte Buildeinstellungen und klicken Sie dann, um Schlüssel-Wert-Paare anzugeben.
Name Beschreibung Beispiel PORT Der Port, den der HTTP-Server überwachen 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 - Optional: Wenn Sie Cloud SQL-Verbindungen angeben möchten, maximieren Sie Erweiterte Diensteinstellungen, klicken Sie auf Verbindungen und geben Sie dann eine Cloud SQL-Verbindung pro Zeile an.
- Optional: Aktivieren Sie die Option Dienst von anderen Geräten im lokalen Netzwerk aus zugänglich machen.
- Optional: Wenn Sie Ihren Dienst nur manuell neu erstellen und ausführen möchten, anstatt automatisch bei einer Änderung, deaktivieren Sie die Option Bei Änderungen automatisch neu erstellen und ausführen.
Dienst lokal ausführen
Nachdem Sie Ihre bevorzugten Einstellungen festgelegt haben, führen Sie den Dienst aus, indem Sie auf Ausführen klicken.
Wenn Sie dazu aufgefordert werden, authentifizieren Sie Ihre Anmeldedaten, um eine Anwendung lokal auszuführen und zu debuggen.
Behalten Sie den Status Ihrer Bereitstellung im Ausgabefenster im Blick.
Nach Abschluss der Bereitstellung können Sie den ausgeführten Dienst anzeigen, indem Sie die im Ausgabefenster angezeigte URL öffnen.
Wenn Sie ausführliche Logs aufrufen möchten, wechseln Sie im Ausgabefenster zur detaillierten Cloud Run-Ansicht.
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:Öffnet die URL des Anwendungsdienstes eines bestimmten Dienstes in einem Webbrowser.
Wenn Sie den Beobachtungsmodus in Ihrer Startkonfiguration deaktiviert haben und Änderungen an Ihrer Anwendung vornehmen und die Anwendung neu erstellen und bereitstellen möchten, klicken Sie auf die Cloud Code-Statusleiste und dann auf Beobachtungsmodus aktivieren.
Klicken Sie in der Aktionsleiste Ihrer aktuellen Bereitstellung auf den Button Beenden, um die Bereitstellung zu beenden.
Secrets speichern
Wenn Ihr Code potenziell vertrauliche Daten wie API-Schlüssel, Passwörter und Zertifikate enthält, können Sie diese als Secrets speichern, um sie zu schützen. Mit der Cloud Code Secret Manager-Integration können Sie diese Secrets sicher speichern und programmatisch abrufen. Eine detaillierte Anleitung zum Erstellen und Verwalten von Secrets mit Cloud Code finden Sie im Secret Manager-Leitfaden.
Vorhandene Konfiguration von "launch.json" anpassen
Das Cloud Code-Plug-in aktualisiert die Konfigurationsdatei launch.json automatisch, wenn Sie eine Ausführungsaktion auswählen. Wenn Sie die Ausführung Ihres Dienstes weiter anpassen möchten, können Sie die folgenden Felder in Ihrer .vscode/launch.json-Datei angeben:
watch: Überwacht Änderungen am Arbeitsbereich und führt den Dienst noch einmal aus. Standardmäßig „true“.
Im folgenden Beispiel ist die Smartwatch auf
trueeingestellt:"watch": true,build: Geben Sie den Builder (Docker, jibMaven, jibGradle oder buildpacks) an, mit dem die Images erstellt werden sollen.
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 zu verwendenden Images an.
Im folgenden Beispiel wird gezeigt, wie ein Bildname angegeben wird:
"image": "hello-world",service: Geben Sie den zu verwendenden Cloud Run-Dienst an.
Im folgenden Beispiel wird gezeigt, wie Sie einen Dienstnamen, einen Port und Ressourcenlimits angeben:
"service": { "name": "hello-world", "containerPort": 8080, "resources": { "limits": { "memory": "256Mi" } } },debug: Geben Sie Debugging-Einstellungen wie die Zuordnung von Remote-Pfaden an, um einen lokalen Pfad einem Pfad im Remote-Container zuzuordnen.
Das folgende Beispiel zeigt einen Debug-Abschnitt, in dem der Speicherort der Quelldateien angegeben ist:
"debug": { "sourceFileMap": { "${workspaceFolder}": "/app" } }