Kurzanleitung: Kubernetes-Anwendung mit Cloud Code ausführen

Auf dieser Seite werden die ersten Schritte mit Cloud Code beschrieben.

In dieser Kurzanleitung richten Sie eine neue Kubernetes-Anwendung mit einer Startvorlage "Hello World" ein, erstellen einen Cluster, führen Ihre Anwendung in diesem Cluster aus, starten die kontinuierliche Neuerstellung zur iterativen Entwicklung der Anwendung, beheben Fehler im ausgeführten Code und beobachten die Logs, die von Ihrer Live-Anwendung gestreamt werden.

Neue

Hinweis

Wenn Sie Google Cloud verwenden möchten, müssen Sie ein Google Cloud-Projekt erstellen und die Abrechnung aktivieren.

Alternativ können Sie einen Cluster verwenden, der auf jeder anderen Cloud-Plattform oder in einem lokalen Kubernetes-Cluster gehostet wird, mit Tools wie Minikube und Docker Desktop.

Plug-in installieren

So installieren Sie das Cloud Code-Plug-in:

  1. Installieren Sie JetBrains-IDE ab Version 2019.3+ (z. B.IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand), falls noch nicht geschehen.
  2. Für alle Cloud-Plattformen muss der Docker-Client (authentifiziert mit Ihrer Docker-Registry) auf dem PATH Ihres Computers installiert sein. Der entsprechende Ordner sollte in einem Verzeichnis in PATH sichtbar sein. Wenn Sie prüfen möchten, ob Docker bereits installiert ist, führen Sie docker -v aus.

    Cloud Code installiert automatisch andere erforderliche Abhängigkeiten.

  3. Öffnen Sie IntelliJ IDEA oder eine der unterstützten JetBrains-IDEs.

  4. Öffnen Sie den Marketplace für Plug-ins über Datei > Einstellungen > Plug-ins oder für Mac OS X mit IntelliJ IDEA > Einstellungen > Plug-ins. Suchen Sie dort nach dem Plug-in "Cloud Code" und installieren Sie es.

    Eventuell werden Sie aufgefordert, die IDE neu zu starten, um das Plug-in zu aktivieren.

Cluster erstellen

Bevor Sie Ihre Anwendung erstellen, benötigen Sie einen verknüpften Kubernetes-Cluster, der entweder lokal mit Minikube oder mit einer Cloud Platform wie einem Google Kubernetes Engine-Cluster gehostet wird. Wenn Sie noch keinen Cluster für diese Kurzanleitung haben, erstellen Sie einen.

Wenn Sie Google Cloud verwenden, können Sie einen GKE-Cluster erstellen, indem Sie die folgenden Schritte ausführen:

  1. Erstellen Sie entweder über Ihr Terminal oder die Cloud Console einen neuen Cluster in GKE.

    • Führen Sie zum Erstellen eines Clusters mit dem Terminal, auf das Sie über die Taskleiste unten in Ihrer IDE zugreifen können, folgenden Befehl aus:

       gcloud container clusters create [CLUSTER_NAME] --zone [COMPUTE_ZONE]
      
    • Klicken Sie zum Erstellen eines Clusters mit der Cloud Console im Google Kubernetes Engine-Menü auf Cluster erstellen.

      Zum Google Kubernetes Engine-Menü

      Weitere Informationen zur Feldanpassung finden Sie im GKE-Leitfaden.

  2. Nachdem Sie einen Cluster erstellt haben, müssen Sie ihn Ihrer lokalen kubeconfig-Datei hinzufügen. Führen Sie dazu den folgenden Befehl aus:

     gcloud container clusters get-credentials [CLUSTER_NAME]
    

    Dadurch wird auch der angegebene Cluster auf den aktiven Kontext gesetzt.

Anwendung erstellen

So erstellen Sie eine neue Anwendung mit einem vorhandenen Beispiel:

  1. Öffnen Sie in Ihrer IDE Datei > Neues Projekt und wählen Sie Cloud Code: Kubernetes aus.
  2. Wählen Sie aus der Liste der Startanwendungen eine "Hello World"-Vorlage aus. Liste der verfügbaren Vorlagen:
  3. Wenn Sie IntelliJ IDEA verwenden, werden Sie aufgefordert, anzugeben, wo Ihr Container-Image gespeichert wird.

    Geben Sie im Feld Ihr Standard-Image-Repository im Format gcr.io/{gcp-project-name} oder docker.io/{account} an.

    Wählen Sie je nach Container Registry ein geeignetes Format aus:

    • Wenn Sie GKE verwenden, können Sie Ihre Images im Google Container Repository speichern.

      Darüber hinaus verfügt das Feld über eine automatische Vervollständigung, sodass Sie das Image, das Ihrem bevorzugten Google Cloud-Projekt und dem aktuell aktiven Cluster zugeordnet ist, einfach finden können. Verwenden Sie das folgende Format:

      gcr.io/{project-name}, wobei {project-name} der Name des GCP-Projekts ist, das den Cluster enthält.

    • Verwenden Sie das folgende Format, wenn Sie Ihre Images in Docker Hub speichern (achten Sie bei Verwendung eines privaten Docker Hub-Repositorys auf eine ordnungsgemäße Authentifizierung):

      docker.io/{account}, wobei {account} der Name Ihres Docker Hub-Kontos ist.

    • Wenn die Ausführung auf einem lokalen Cluster wie Minikube oder Docker Desktop erfolgt, können Sie diesen Schritt überspringen und auf "Weiter" klicken.

  4. Wählen Sie einen Namen für Ihr Projekt aus.

    Sobald Sie auf Fertigstellen klicken, klont Cloud Code die ausgewählte Vorlage und öffnet das neu erstellte Projekt.

    • Bei Java-Vorlagen werden Sie aufgefordert, Maven-Projekte zu importieren, um Ihre pom.xml-Datei zu synchronisieren. Klicken Sie auf "Add as Maven project".

      Grafik: Benachrichtigung über nicht verwaltete pom.xml-Datei

      Importieren Sie außerdem die erforderlichen Maven-Projekte durch Klicken auf "Import Changes".

      Benachrichtigung zum Import von Maven-Änderungen

Anwendung entwickeln

So starten Sie die Entwicklung Ihrer Anwendung in Kubernetes:

  1. Achten Sie darauf, dass Sie für Develop on Kubernetes definiert haben, wo Ihre Container-Images gespeichert werden.
  2. Wählen Sie das Ausführungsziel Develop on Kubernetes im Dialogfeld "Run/Debug configurations" in der oberen Taskleiste aus.

    Dadurch wird sichergestellt, dass Codeänderungen automatisch erstellt, per Push übertragen und in einer neuen Version Ihrer Anwendung bereitgestellt werden.

    Kubernetes-Deployment-Ausführungskonfigurationen

    Klicken Sie auf die Ausführungsaktion für "Develop on Kubernetes" Symbol für Ausführungsaktion, um den Entwicklungszyklus für einen Kubernetes-Cluster zu starten.

  3. Sehen Sie sich im Ausgabefenster die eingehenden Anwendungslogs an.

    Nach dem Start des Deployments wird die Liste der weitergeleiteten Ports für die bereitgestellte Anwendung angezeigt.

    Gestreamte Logs über die Kubernetes-Anwendung aufrufen

  4. Wenn die Bereitstellung erfolgreich war, werden Sie mit einer Benachrichtigung darüber informiert, dass der Dienst jetzt über lokale URLs zugänglich ist. Klicken Sie auf „Anzeigen“, um das Ereignisprotokoll zu öffnen.

    Benachrichtigung zur Angabe der URL, um auf deine Live-App zuzugreifen, ist jetzt im Ereignisprotokoll verfügbar

    Klicken Sie im Event Log auf den Link, um den Browser mit Ihrer ausgeführten Anwendung zu öffnen.

    Portweiterleitungsdienste mithilfe von

Anwendung debuggen

So beheben Sie Fehler in der Anwendung:

  1. Achten Sie darauf, dass Sie für Develop on Kubernetes definiert haben, wo Ihre Container-Images gespeichert werden.
  2. Klicken Sie auf die Debug-Aktion Symbol für Ausführungsaktion für Develop on Kubernetes, um den Entwicklungszyklus im Debug-Modus auf Ihrem Kubernetes-Cluster zu starten.

    Kubernetes-Cluster-Entwicklungszyklus im Debug-Modus starten

  3. Cloud Code hängt dann eine Debug-Sitzung an. Nach Abschluss des Vorgangs wird das Fenster mit dem Debugging-Tool geöffnet und die Verbindung bestätigt (auf dem Tab "Console").

    Sie können jetzt Fehler in Ihrem Live-Kubernetes-Cluster beheben.

  4. Klicken Sie auf den Bundsteg bei der ausführbaren Zeile des Codes, bei der Sie einen Haltepunkt hinzufügen möchten.

    Rot ausgefüllte Kreise kennzeichnen aktive Haltepunkte, während rot umrandete Kreise deaktivierte Haltepunkte angeben.

  5. Wenn Sie eine neue Anfrage an Ihre Anwendung senden, wird sie in der gewünschten Zeile pausiert.

    Kubernetes Debugger-Sitzung

  6. Klicken Sie zum Beenden der Debugging-Sitzung auf das Stopp-Symbol in der Ausführungskonfiguration für Develop on Kubernetes.

Anwendung ausführen

So führen Sie eine Anwendung in Kubernetes aus:

  1. Achten Sie darauf, dass Sie für Run on Kubernetes definiert haben, wo Ihre Container-Images gespeichert werden.
  2. Die Anwendung ist nun für das Deployment bereit. Wählen Sie im Dialogfeld der oberen Taskleiste "Run/Debug configurations" die Option Run on Kubernetes aus, um die Anwendung bereitzustellen.

    Kubernetes-Deployment-Ausführungskonfigurationen

  3. Klicken Sie auf "Run on Kubernetes" Symbol für Ausführungsaktion.

  4. Wie bei der Entwicklung in Kubernetes können Sie eingehende Anwendungslogs im Ausgabefenster anzeigen.

  5. Wenn die Bereitstellung erfolgreich war, werden Sie mit einer Benachrichtigung darüber informiert, dass der Dienst jetzt über lokale URLs zugänglich ist. Klicken Sie auf "Anzeigen", um das Ereignisprotokoll zu öffnen.

    Suchen Sie im Event Log nach dem Port, an dem Ihre Anwendung bereitgestellt wird. Klicken Sie auf den Link, um den Browser mit Ihrer ausgeführten Anwendung zu öffnen.

  6. Rufen Sie http://localhost:{port-number} auf, um auf Ihre neu bereitgestellte Anwendung zuzugreifen.

    Anwendung unter http://localhost:{port-number}, bei der

Logs ansehen

Sie können bei der Entwicklung und Ausführung Ihrer Anwendung einen Livestream der Logs aus ausgeführten Pods in der Terminalausgabe sehen. Außerdem haben Sie die Möglichkeit, Logs von einem bestimmten Pod anzusehen. Rufen Sie dazu den Kubernetes Explorer auf.

So rufen Sie Logs eines bestimmten Pods auf:

  1. Rufen Sie den Kubernetes Explorer auf. Sie können entweder über die rechte Seitenleiste oder über Tools > Cloud Code > Kubernetes > View Cluster Explorer darauf zugreifen.

    Das Kubernetes Explorer-Steuerfeld wird über den Tab in der rechten Taskleiste geöffnet

  2. Wählen Sie den Pod aus, für den Sie Logs aufrufen möchten.

  3. Klicken Sie mit der rechten Maustaste auf den Pod und wählen Sie Logs streamen aus. Alternativ können Sie Logs für einzelne Container streamen, die in Pods ausgeführt werden.

    Dadurch werden Logs in der Kubernetes Explorer Console ausgegeben.

    Streamen von Logs eines Pods über das Kontextmenü, um die Logs in der Kubernetes Explorer-Konsole auszugeben

Bereinigen

Damit Ihr Konto nicht für die in dieser Kurzanleitung verwendeten Ressourcen belastet wird, müssen Sie den von Ihnen erstellten Cluster und das Projekt löschen.

Wenn Sie Google Cloud verwenden und Ihr Projekt und die zugehörigen Ressourcen, einschließlich GKE-Cluster, löschen möchten:

  • Rufen Sie in der Cloud Console die Seite "Projekte" auf:

    Zur Seite "Projekte"

  • Wählen Sie das Projekt aus, das Sie für diesen Schnellstart erstellt haben, und klicken Sie auf das Papierkorbsymbol, um es zu löschen.

    Das Projekt wird beendet und der Löschvorgang geplant.

Nächste Schritte

Support

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