Kurzanleitung: Kubernetes-Anwendung mit Cloud Code for VS Code bereitstellen

Kubernetes-Anwendung mit Cloud Code für VS Code bereitstellen

Auf dieser Seite finden Sie Hinweise für einen schnellen Einstieg in Cloud Code.

Sie richten eine neue Kubernetes-Anwendung mithilfe einer Beispielanwendung ein, erstellen einen Cluster, führen Ihre Anwendung in diesem Cluster aus, debuggen Fehler in Ihrem ausgeführten Code, rufen Logs aus Ihrer Anwendung auf und verbinden ein Terminal mit Ihrem ausgeführten Container.

Wenn Sie einen Apple-Computer verwenden, der M-Series Silicon verwendet, müssen Sie Cloud Build für die Bereitstellung in Cloud Run verwenden. Hier werden nur x86-Images unterstützt (es können Gebühren anfallen). Mit Cloud Code können Sie mit Cloud Build x86-Images erstellen. Weitere Informationen finden Sie unter Cloud Code-Unterstützung für Apple M-Serie Silicon.

Hinweis

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  4. Google Kubernetes Engine API aktivieren.

    Aktivieren Sie die API

  5. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  6. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  7. Google Kubernetes Engine API aktivieren.

    Aktivieren Sie die API

  8. Installieren Sie Git. Git ist zum Kopieren von Beispielen auf Ihren Computer erforderlich.

Cloud Code installieren

  1. Installieren Sie Visual Studio Code auf Ihrem Computer, falls noch nicht geschehen.

  2. Installieren Sie für alle Cloud-Plattformen den Docker-Client (authentifiziert mit Ihrer Docker-Registry) auf dem PATH Ihres Computers (der Installationsordner sollte unter einem Verzeichnis in Ihrem PATH sichtbar sein).

    • Wenn Sie prüfen möchten, ob Docker bereits installiert ist, führen Sie docker -v aus.
    • Wenn Sie Windows Home verwenden, finden Sie weitere Informationen unter Docker Desktop auf Windows Home installieren.
    • Wenn Sie WSL verwenden, Docker jedoch nicht für Computer installieren können, verwenden Sie stattdessen Minikube für die lokale Entwicklung mit Cloud Code.

    Cloud Code installiert automatisch kubectl, Skaffold und die gcloud-Befehlszeile.

  3. Installieren Sie Cloud Code mit einer der folgenden Optionen:

    • Öffnen Sie VS Code und installieren Sie Cloud Code.
    • Öffnen Sie Visual Studio Code auf Ihrem Computer. Suchen Sie in VS Code in der Ansicht Erweiterungen Erweiterungssymbol (Symbol in der linken Taskleiste) nach der Erweiterung Cloud Code und klicken Sie auf Installieren.

    Wenn Sie Cloud Code für VS Code auf einem Apple-Prozessor der M-Serie ausführen, werden Sie zur Installation von Rosetta 2 oder zur Deaktivierung der automatischen Abhängigkeiten aufgefordert, damit Rosetta 2 auf Ihrem System funktioniert.

    Nach Abschluss der Installation sehen Sie die Cloud Code-Willkommensseite und eine Sammlung von Beispielanwendungen unter Starter-Apps, mit denen Sie schnell eine neue Anwendung einrichten können. Die Cloud Code-Statusleiste ist mit gängigen Cloud Code-Aktionen ausgestattet und befindet sich in der VS Code-Statusleiste.

Anwendung erstellen

  1. Führen Sie in der Befehlspalette (drücken Sie Cmd/Ctrl + Shift + P) die Option Cloud Code: Neue Anwendung aus und wählen Sie Kubernetes-Anwendung aus.

  2. Wählen Sie eine Hello World-Anwendung in der gewünschten Sprache aus.

    Wenn Sie beispielsweise Node.js: Hello World auswählen, wird eine Hello World-Startanwendung in Node.js erstellt.

  3. Speichern Sie die neue Anwendung.

    In einer Benachrichtigung wird bestätigt, dass die Anwendung erstellt wurde, und die Anwendung wird in einem neuen Fenster geöffnet.

GKE-Cluster erstellen

So erstellen Sie einen GKE-Standardcluster (Google Kubernetes Engine):

  1. Klicken Sie auf Symbol: Cloud Code Cloud Code und maximieren Sie den Abschnitt Kubernetes.

  2. Klicken Sie auf + Cluster zu KubeConfig hinzufügen und wählen Sie Google Kubernetes Engine aus.

  3. Wenn Sie dazu aufgefordert werden, den Container zu aktivieren, wählen Sie Ja aus.

  4. Wählen Sie Standard als Clustertyp aus.

  5. Klicken Sie auf Öffnen, damit Cloud Code die Cloud Console öffnen kann.

  6. Verwenden Sie in der Cloud Console das von Ihnen erstellte Projekt. Setzen Sie die Zone auf us-central1-a und den Clusternamen auf my-first-cluster.

  7. Klicken Sie auf Erstellen. Die Clustererstellung dauert einige Minuten.

  8. Nachdem der Cluster erstellt wurde, klicken Sie im maximierten Abschnitt Kubernetes auf Kubernetes-Clusteransicht aktualisieren Aktualisieren.

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

Anwendung ausführen und aufrufen

Jetzt können Sie die Anwendung ausführen und live ansehen. Darüber hinaus beobachtet Cloud Code 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:

  1. Klicken Sie auf die Cloud Code-Statusleiste und wählen Sie Run on Kubernetes aus.
  2. Prüfen Sie, ob Sie den aktuellen Clusterkontext verwenden oder zu einem anderen Kontext wechseln möchten.
  3. Wenn Sie dazu aufgefordert werden, wählen Sie eine Image-Registry aus, in die die Images übertragen werden sollen.

    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.

  4. Sobald Ihre Anwendung in Kubernetes ausgeführt wird, wird im Ausgabefenster eine IP-Adresse angezeigt. Drücken Sie Ctrl/Cmd und klicken Sie auf die Adresse, um diese verknüpfte IP-Adresse für den Zugriff auf Ihre Anwendung zu verwenden.

Tipps zur Fehlerbehebung

Wenn Sie einen bereits vorhandenen Cluster verwenden, gehen Sie so vor, um den Cluster als aktiv festzulegen und die Clusteranmeldedaten abzurufen:

  1. Klicken Sie auf Symbol: Cloud Code Cloud Code und maximieren Sie den Abschnitt Kubernetes.

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

  1. Klicken Sie auf die Cloud Code-Statusleiste und wählen Sie Debug in Kubernetes aus.

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

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

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

    Abschnitt "Breakpoints" im linken Bereich der Fehlerbehebungsansicht, über die Haltepunkte hinzugefügt, entfernt und deaktiviert werden können

    Wenn Sie eine neue Anfrage an Ihre Anwendung senden, wird der Debugger am ersten aktiven Haltepunkt angehalten.

    Im folgenden Beispiel ist unter Lokalim Abschnitt Variablender Wert von res._contentLength; für Hello, world! 13.

    Eine Anwendung, die am Haltepunkt angehalten wurde und deren Variablen und Aufrufstapel mit Werten im entsprechenden Bereich gefüllt wurden

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

    Anwendung an Haltepunkt angehalten mit aktualisierten Werten

Nachdem die Debugging-Sitzung gestartet wurde, wird im Bereich Entwicklungssitzungen die strukturierte Logging-Ansicht angezeigt. Die Aufgabe wird mit einem sich drehenden halbkreisförmigen Symbol Fortschrittssymbol angezeigt.

Wenn eine Aufgabe erfolgreich ist, wird neben dem Schritt ein grünes Häkchen Erfolgssymbol angezeigt.

Wenn Sie sich Details zu einem Schritt ansehen möchten, klicken Sie auf den Schritt im Bereich Entwicklungssitzung. Im Ausgabebereich wird der Schritt in der Logging-Ausgabe angezeigt.

Terminal im Container öffnen

So öffnen Sie ein Terminal in Ihrem Container:

  1. Klicken Sie auf Symbol: Cloud Code Cloud Code und maximieren Sie den Abschnitt Kubernetes.

  2. Maximieren Sie die folgenden Abschnitte:

    • Ihr bevorzugter Cluster
    • Der Abschnitt Namespaces und dann Ihr bevorzugter Abschnitt für Namespaces
    • Der Bereich Pods und dann der von Ihnen bevorzugte Pod
    • Der Abschnitt Container

    Symbol: Cloud Code

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

Um Kosten für andere in dieser Kurzanleitung verwendete Ressourcen zu vermeiden, sollten Sie den Cluster und das Projekt, die Sie erstellt haben, löschen.

Wenn Sie Google Cloud verwenden und nur Ihren Cluster löschen möchten, führen Sie die folgenden Schritte aus:

  1. Bewegen Sie den Mauszeiger in Kubernetes Explorer auf den Clusternamen und klicken Sie auf Symbol: In der Cloud Console öffnenIn der Cloud Console öffnen.
  2. Klicken Sie auf Löschen und dann auf Löschen.

So löschen Sie Ihr Projekt und die zugehörigen Ressourcen, einschließlich der Cluster:

  1. Rufen Sie in der Cloud Console die Seite „Projekte“ auf:

    Zur Seite „Projekte“

  2. Wählen Sie das Projekt aus, das Sie für diese Kurzanleitung erstellt haben, und klicken Sie dann auf Löschen.

  3. Geben Sie die Projekt-ID ein und klicken Sie auf Beenden.

    Das Projekt wird beendet und der Löschvorgang geplant.

Weitere Informationen