Erste Schritte mit Cloud Code for IntelliJ für Kubernetes

Mit Cloud Code können Sie eine Kubernetes-Anwendung auf der Grundlage eines Beispiels oder eines vorhandenen Projekts erstellen.

Anwendung aus einer Vorlage erstellen

Cloud Code enthält eine Reihe von Codebeispielvorlagen für einen schnellen Einstieg. So erstellen Sie eine Kubernetes-Anwendung mit einem vorhandenen Beispiel:

1. Öffnen Sie File > New Project.
2. Wählen Sie Cloud Code: Kubernetes aus.
3. Wählen Sie eine Vorlage aus der Liste der Startanwendungen aus.

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 Als Maven-Projekt hinzufügen. Importieren Sie außerdem die erforderlichen Maven-Projekte durch Klicken auf Änderungen importieren.

5. Kubernetes- und Entwicklungs-IDE-Ausführungsziele für das Projekt werden automatisch erstellt und können sofort ausgeführt werden.

   Optional: Alternativ können Sie Ausführungsziele manuell erstellen.

   1. Wählen Sie das Drop-down "Ausführungskonfiguration" aus und klicken Sie auf "Konfigurationen bearbeiten".
   2. Klicken Sie auf + Neue Konfiguration hinzufügen, um eine neue Ausführungskonfiguration hinzuzufügen.
   3. Rufen Sie Cloud Code: Kubernetes auf.
   4. Geben Sie einen Namen für die neue Konfiguration ein. Der Standardwert ist „Unbenannt“.
   5. Klicken Sie auf "OK", um das Ausführungsziel zu erstellen.
   Hinweis: Wenn Sie in Ihrer IDE in Google Cloud angemeldet sind und ein Standardprojekt definiert haben, verwendet Cloud Code Ihr Standard-Container-Image-Repository. Informationen zum Festlegen eines anderen Container-Images finden Sie unter Container-Image-Einstellungen konfigurieren.

Eigene Anwendung verwenden

Eine schrittweise Anleitung zur Verwendung eines vorhandenen Projekts finden Sie unter Cloud Code mit einer vorhandenen Kubernetes-Anwendung verwenden.

Hinweis: Erstellen und testen Sie eine Anwendung, indem Sie sie in einem Nicht-Produktionscluster erstellen und ausführen.
Verwenden Sie für Änderungen, die in die Produktion übernommen werden, einen automatisierten CI/CD-Workflow.

Kubernetes-Kontext festlegen

Bevor Sie Ihre Anwendung ausführen, müssen Sie sie einrichten, um sie in Ihrem bevorzugten Kubernetes-Kontext bereitzustellen. Sie können dies in der Konfiguration angeben.

Wenn Sie den aktuellen Kontext ändern möchten, können Sie dies mit dem Kubernetes Explorer tun, der entweder über den Seitenleistenbereich auf der rechten Seite oder über Tools > Cloud Code > Kubernetes > Cluster-Explorer ansehen verfügbar ist.

Zur Optimierung Ihrer Entwicklungsschleife, indem Sie Dateiänderungen eines bestimmten Typs schnell übernehmen, ohne eine Image-Neuerstellung durchführen zu müssen, können Sie Dateisynchronisierung und Hot Reload aktivieren.

Konfiguration

Wenn Sie die Ausführungskonfiguration Cloud Code: Develop on Kubernetes verwenden, können Sie Ihre Bereitstellung durch Konfigurieren der verfügbaren Einstellungen anpassen.

Rufen Sie Ausführen > Konfigurationen bearbeiten auf, um Konfigurationen hinzuzufügen oder zu bearbeiten.

Speicheroptionen für Container-Images

Wenn Sie einen Remote-Cluster als Kontext ausgewählt haben, wählen Sie eine Image-Registry aus, in die die Images übertragen werden sollen. Rufen Sie Ausführen > Konfigurationen bearbeiten auf, um die Image-Registry in den Ausführungs-/Fehlerbehebungskonfigurationen festzulegen.

Weitere Informationen finden Sie im Leitfaden zum Speichern des Container-Images.

Build-Einstellungen

Cloud Code unterstützt die Artefakttypen Docker, Jib und Buildpacks. Informationen zum Festlegen Ihres bevorzugten Builders und der relevanten Einstellungen finden Sie im Leitfaden „Build-Einstellungen für Container-Images konfigurieren“.

Startkonfiguration anpassen

Sie können die Datei skaffold.yaml anpassen, um zu konfigurieren, wie Ihre Anwendung ausgeführt wird.

Sie können den Start auch unter Ausführungs-/Fehlerbehebungskonfigurationen konfigurieren. Rufen Sie zum Bearbeiten der Konfigurationen Ausführen > Konfigurationen bearbeiten auf.

Weitere Informationen zum Anpassen der Startkonfiguration finden Sie unter Kubernetes in Cloud Code.

Hinweis: Cloud Code wurde für die Arbeit mit Cloud Build entwickelt. Informationen zum Erstellen einer vorhandenen Anwendung mit der Google Cloud-Infrastruktur finden Sie in den Skaffold-Dokumenten für Cloud Build.

Führen Sie Ihre Anwendung aus

Sobald Sie eine Anwendung eingerichtet haben, können Sie sie in einem Kubernetes-Cluster ausführen und mithilfe von skaffold dev live ansehen. Sie können Ihre Anwendung auf einem lokalen Cluster wie Minikube oder Docker Desktop, in Google Kubernetes Engine oder in jedem anderen Cloud-Anbieter ausführen.

Hinweis: Wenn Sie mit einem privaten Autopilot-Cluster arbeiten, kann beim Abrufen eines Images außerhalb der Image-Registry für Ihr Projekt ein Image-Abruffehler auftreten, z. B. mit Docker Hub. Zur Behebung dieses Problems können Sie das Image entweder in Container Registry hosten oder ausgehenden Internetzugriff für Ihre privaten Knoten bereitstellen.

1. Klicken Sie bei der gewünschten Ausführungsaktion auf das Symbol Ausführen. Sie können dann eingehende Anwendungslogs im Ausgabefenster auf dem Tab Logs anzeigen.

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

2. Nach erfolgreicher Bereitstellung werden Sie darüber informiert, dass neue Dienst-URLs verfügbar sind. Klicken Sie auf den Tab Dienst-URLs, um die URL(s) anzuzeigen, und klicken Sie dann auf den URL-Link, um Ihren Browser mit der laufenden Anwendung zu öffnen.

   Alternativ können Sie das Ereignisprotokoll öffnen und dann auf den Link klicken, um den Browser mit Ihrer ausgeführten Anwendung zu öffnen.

   Im Bereich Bereitgestellte Ressourcen wird angezeigt, was Sie während der Entwicklungssitzung bereitgestellt haben.

Logs ansehen

Sie können Logs von laufenden Pods nicht nur als Livestream in der Terminalausgabe sehen, wenn Sie Ihre Anwendung entwickeln und ausführen. Sie können Logs von einem bestimmten Pod auch im Kubernetes Explorer aufrufen.

So rufen Sie Logs eines bestimmten Pods auf:

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

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

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

   In der Kubernetes Explorer Console werden die Logs angezeigt.

Änderungen vornehmen, neu erstellen und bereinigen

Wenn der Wiedergabemodus in Ihrer Startkonfiguration auf On Demand festgelegt ist und Sie Änderungen an Ihrer Anwendung vornehmen und die Anwendung anschließend neu erstellen und bereitstellen möchten:

1. Nehmen Sie die gewünschten Änderungen vor und speichern Sie sie.

2. Klicken Sie auf das Symbol Build and Deploy auslösen oder drücken Sie Option + Ctrl/Cmd + Comma, um die Anwendung neu zu erstellen und bereitzustellen.

3. Klicken Sie auf das Symbol Beenden oder drücken Sie Ctrl/Cmd + F2, um die Ausführung der Anwendung zu beenden.

Nachdem Sie die Anwendung beendet haben, werden alle bereitgestellten Kubernetes-Ressourcen aus dem Cluster gelöscht. Sie können dieses Verhalten mit dem Flag cleanUp in der Startkonfiguration ändern.

Secrets speichern

Wenn Ihr Code potenziell sensible Daten wie API-Schlüssel, Passwörter und Zertifikate enthält, sollten Sie diese als Secrets speichern. Mit Cloud Code können Sie diese Secrets sicher in Secret Manager speichern und sie bei Bedarf programmatisch abrufen.

Eine detaillierte Beschreibung dazu, wie Sie Secrets mit Cloud Code erstellen und verwalten können, finden Sie in der Anleitung zu Secret Manager.

Ressourcendetails aufrufen

Im Kubernetes Explorer werden Cluster, Namespaces, Knoten, Arbeitslasten (z. B. Deployments, Replikatsets, Pods und Container), Dienste und Ingress-Ressourcen, Konfigurationen (z. B. Secrets und Konfigurationszuordnungen) und Speicher (z. B. Volumes) angezeigt. Mit dem Kubernetes Explorer können Sie für einige dieser Ressourcen einzigartige Aktionen ausführen.

Weitere Informationen zum Aufrufen von Ressourcendetails finden Sie in der Kubernetes-Übersicht.

Nächste Schritte

• Build-Optionen mit Buildpacks, Jib oder Docker kennenlernen
• Verwenden Sie Dateisynchronisierung und Hot Refresh, um die Entwicklung zu beschleunigen.
• Weitere Informationen zur Unterstützung bei der YAML-Bearbeitung von Cloud Code.

Support kontaktieren

So senden Sie Feedback oder melden ein Problem in Ihrer IntelliJ-IDE: Tools > Cloud Code > Hilfe / Info > Feedback geben oder Problem melden, um ein Problem auf GitHub zu melden oder stellen Sie eine Frage zu Stack Overflow.