Kubernetes-Anwendung mit Remote-Entwicklung bereitstellen
Auf dieser Seite wird beschrieben, wie Sie für einen schnellen Einstieg in Cloud Code for VS Code eine Remote-Entwicklungsumgebung in Cloud Shell nutzen können.
In dieser Kurzanleitung überspringen Sie mit einem Klick das Einrichten und Klonen eines Projekts in den Arbeitsbereich für die Remote-Entwicklung. Sie erstellen einen Cluster, führen eine Kubernetes-Anwendung auf diesem Cluster aus, beheben Fehler im ausgeführten Code, sehen sich Logs aus Ihrer Live-Anwendung an und verbinden außerdem ein Terminal mit dem ausgeführten Container.
Hinweis
Führen Sie die folgenden Schritte aus, um unterstützende Ressourcen einzurichten und auf Cloud Shell zuzugreifen: die Remote-Entwicklungsumgebung in Google Cloud , die Sie in diesem Schnellstart in VS Code verwenden:
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Installieren Sie Visual Studio Code auf Ihrem Computer, falls noch nicht geschehen.
- Installieren Sie die Visual Studio Code-Erweiterung Remote – SSH.
- Installieren Sie Git. Git ist zum Kopieren von Beispielen auf Ihren Computer erforderlich.
- Installieren Sie das Cloud Code-Plug-in, falls noch nicht geschehen.
Cloud Code starten
Wenn Sie Visual Studio Code öffnen, das mit einer Remote-Entwicklungsumgebung in Cloud Shell verbunden ist, enthält die Umgebung alle Tools, die Sie zum Entwickeln von Kubernetes-Anwendungen benötigen.
Wählen Sie zum Starten der Arbeit im Remote-Entwicklungsarbeitsbereich Ihre bevorzugte Sprache für das geklonte Projekt aus und klicken Sie auf die Schaltfläche Mit Cloud Code öffnen:
Node.js
Java
Python
Go
VS Code startet ein Projekt und klont es in Ihrem Arbeitsbereich für die Remote-Entwicklung.
Wenn Sie die benötigten Komponenten noch nicht eingerichtet haben, werden Sie aufgefordert, sie zu installieren.
GKE-Cluster erstellen
So erstellen Sie einen GKE-Standardcluster (Google Kubernetes Engine):
Klicken Sie auf
Cloud Code und maximieren Sie den Bereich Kubernetes.
Klicken Sie auf Hinzufügen und dann auf KubeConfig einen Cluster hinzufügen. Klicken Sie dann im Menü Schnellauswahl auf Google Kubernetes Engine.
Wählen Sie Ja aus, wenn Sie aufgefordert werden,
container.googleapis.com
zu aktivieren.Klicken Sie auf + Neuen GKE-Cluster erstellen.
Wählen Sie Standard als Clustertyp aus.
Klicken Sie auf Öffnen, damit Cloud Code die Google Cloud Console öffnen kann.
Verwenden Sie in der Google Cloud Console das von Ihnen erstellte Projekt, legen Sie für die Zone den Wert
us-central1-a
und für den Clusternamen den Wertmy-first-cluster
fest.Klicken Sie auf Erstellen. Die Clustererstellung dauert einige Minuten.
Klicken Sie nach dem Erstellen des Clusters im Menü Schnellauswahl auf Aktualisieren und dann auf Aktualisieren.
Wenn der Name des neuen Clusters in der Liste angezeigt wird, klicken Sie auf den Clusternamen. Der neue Cluster wird der Konfiguration hinzugefügt und als aktiver Kontext konfiguriert.
App ausführen und ansehen
Jetzt können Sie die Anwendung ausführen und live ansehen. Cloud Code beobachtet Ihr Dateisystem auf Änderungen, sodass Sie Ihre Anwendung nahezu in Echtzeit bearbeiten und noch einmal ausführen können.
So führen Sie Ihre Anwendung aus:
Klicken Sie in der Cloud Code-Statusleiste auf den Namen des aktiven Projekts.
Wählen Sie im angezeigten Menü „Schnellauswahl“ die Option Auf Kubernetes ausführen aus.
Prüfen Sie, ob Sie den aktuellen Clusterkontext verwenden oder zu einem anderen Kontext wechseln möchten.
Wenn Sie dazu aufgefordert werden, wählen Sie eine Image-Registry aus, in die die Images übertragen werden sollen. Wenn Sie mit
gcr.io/PROJECT_ID
eine neue Image-Registry erstellen, muss sich diese im selben Projekt wie Ihr Cluster befinden.Ein Ausgabefenster wird angezeigt, in dem Sie den Fortschritt Ihrer ausgeführten Anwendung verfolgen können. Außerdem sehen Sie in der Terminalausgabe einen Livestream der Logs der ausgeführten Pods.
Sobald Ihre Anwendung in Kubernetes ausgeführt wird, wird im Ausgabefenster eine IP-Adresse angezeigt. Um mit dieser verknüpften IP-Adresse auf Ihre Anwendung zuzugreifen, drücken Sie
Ctrl
/Cmd
und klicken Sie auf die Adresse.
Tipps zur Fehlerbehebung
Wenn Sie einen bereits vorhandenen Cluster verwenden, legen Sie Ihren Cluster als aktiv fest und rufen Clusteranmeldedaten ab:
Klicken Sie auf
Cloud Code und maximieren Sie den Bereich Kubernetes.
Klicken Sie mit der rechten Maustaste auf den Clusternamen und dann auf Als aktiven Cluster festlegen.
Anwendung debuggen
So beheben Sie Fehler in Ihrer Anwendung:
Klicken Sie in der Cloud Code-Statusleiste auf den Namen des aktiven Projekts.
Wählen Sie im angezeigten Menü „Schnellauswahl“ die Option Unter Kubernetes debuggen aus.
Authentifizieren Sie Ihre Anmeldedaten, um eine Anwendung lokal auszuführen und zu beheben, wenn Sie dazu aufgefordert werden.
Wenn Sie dazu aufgefordert werden, bestätigen Sie, ob Sie den aktuellen Clusterkontext verwenden oder zu einem bevorzugten Kontext wechseln möchten.
Cloud Code verwendet die
cloudcode.kubernetes
-Konfigurationen in Ihrer.vscode/launch.json
-Datei, um Ihre Anwendung auszuführen und eine Debugger-Sitzung hinzuzufügen.Cloud Code erstellt Ihre Container, verschiebt sie in die Registry, wendet Kubernetes-Konfigurationen auf den Cluster an und gibt die IP-Adresse zurück, mit der Sie Inhalte in Ihrer Live-Anwendung suchen können.
Vor dem Anhängen der Debugger-Sitzung werden Sie aufgefordert, das Verzeichnis im Remote-Container zu bestätigen oder einzugeben, in dem sich das Programm befindet, für das das Debugging durchgeführt werden soll (oder drücken Sie die ESC-Taste, um das Debuggen des Containers zu überspringen).
Um zu Zeile 9 einen Haltepunkt hinzuzufügen, öffnen Sie
src/app.js
und klicken Sie dann auf den Rand des Editors.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 "Breakpoints" in der Fehlerbehebungsansicht von VS Code verwenden.
Wenn Sie eine neue Anfrage an Ihre Anwendung senden, wird der Debugger am ersten aktiven Haltepunkt angehalten.
Beachten Sie im folgenden Beispiel unter Lokal im Abschnitt Variablen, dass der Wert von
res._contentLength;
fürHello, world!
13 ist.Bearbeiten Sie den in Zeile 8 an
Hello, goodbye!
gesendeten String und starten Sie dann die Aktion Debuggen in Kubernetes neu.Beachten Sie den aktualisierten Wert von
res._contentLength
, nachdem die Anwendung neu erstellt und neu bereitgestellt wurde.
Nach dem Start der Debugging-Sitzung wird im Bereich Entwicklungssitzungen die strukturierte Logging-Ansicht angezeigt. Wenn eine Aufgabe beginnt, wird die Aufgabe mit einem rotierenden Halbkreis progress_activity angezeigt.
Wenn eine Aufgabe erfolgreich ist, wird neben dem Schritt ein Häkchen check_circle angezeigt.
Klicken Sie auf den Schritt im Bereich Entwicklungssitzung, um die Details eines Schritts anzuzeigen. Im Ausgabebereich wird der Schritt in der Logging-Ausgabe angezeigt.
Terminal im Container öffnen
So öffnen Sie ein Terminal in Ihrem Container:
Klicken Sie auf
Cloud Code und maximieren Sie den Bereich Kubernetes.
Maximieren Sie die folgenden Abschnitte:
- Im Bereich Ihres bevorzugten Clusters
- den Bereich Namespaces und dann den Bereich Ihres bevorzugten Namespaces
- Im Bereich Pods und dann im Bereich des gewünschten Pods
Bereich Container
Klicken Sie mit der rechten Maustaste auf den Container, in dem Sie ein Terminal öffnen möchten, und klicken Sie dann auf Terminal abrufen.
Dadurch wird ein Terminal gestartet. Sie haben jetzt Zugriff auf eine Shell im ausgeführten Container.
Bereinigen
Nachdem Sie Ihre Anwendung beendet haben, werden alle während der Ausführung bereitgestellten Kubernetes-Ressourcen automatisch gelöscht.
Damit Ihr Konto nicht für andere in dieser Kurzanleitung verwendete Ressourcen belastet wird, müssen Sie das Projekt oder den Cluster, den Sie erstellt haben, löschen, wenn Sie das Projekt wiederverwenden möchten.
So löschen Sie den Cluster:
- Klicken Sie auf
Cloud Code und maximieren Sie dann den Kubernetes Explorer.
- Bewegen Sie den Mauszeiger auf den Clusternamen und klicken Sie dann auf open_in_new (In Google Cloud Console öffnen).
- Klicken Sie auf Löschen und dann noch einmal auf Löschen.
So löschen Sie Ihr Projekt und die zugehörigen Ressourcen, einschließlich der Cluster:
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
Nächste Schritte
- Ziehen Sie in Betracht, eine vorhandene Anwendung in VS Code zu importieren und mit Cloud Code einzurichten.
- Nutzen Sie die erweiterte Google Cloud- und Kubernetes-Konfiguration mit der Unterstützung für die YAML-Bearbeitung von Cloud Code. Google Cloud
- Entdecken Sie den sprachspezifischen Debugging-Support von Cloud Code.
- Mit Dateisynchronisierung und Hot Reload können Sie Ihre Entwicklung beschleunigen.
- GKE-Cluster erstellen und konfigurieren
- Private Cluster konfigurieren
- Passen Sie Ihre Cloud Code-Erfahrung an und konfigurieren Sie die relevanten Einstellungen.