Wolkenwald
Plugin · Entwicklung und Betrieb

Kubernetes-Cluster

Das Plugin Kubernetes-Cluster (k8sadmin) verwaltet beliebig viele Kubernetes-Cluster aus der Verwaltung heraus: k3s, Kubernetes mit kubeadm, RKE2, OpenShift und die Angebote der grossen Anbieter wie EKS, AKS und GKE. Im Cluster muss dafür nichts installiert werden — das Plugin spricht ihn über kubectl an.

Cluster eintragen

Ein Cluster ist ein Eintrag mit Namen und Zugang. Für den Zugang gibt es drei Wege:

  • kubeconfig im Tresor: Der Inhalt wird einmal eingefügt und liegt danach im Tresor. Er wird nie wieder angezeigt und steht nie in der Datenbank, in einer Antwort, einem Ereignis oder im Verlauf. Für jeden Aufruf schreibt das Plugin ihn in eine Datei, die nur es lesen kann, und löscht sie danach.
  • kubeconfig-Datei auf dem Server, etwa die eines k3s-Servers.
  • Dienstkonto, wenn PurePower selbst im Cluster läuft.

Empfohlen ist ein Dienstkonto mit genau den nötigen Rechten statt der Admin-kubeconfig. Darf es nicht clusterweit lesen, fragt das Plugin je Namespace. Ist kein Tresor eingerichtet, liegen die Zugangsdaten in einer geschützten Datei des Plugins; kommt der Tresor später dazu, zieht das Plugin sie selbst dorthin um.

Fehlt kubectl auf dem Server, lädt das Plugin das offizielle Programm, prüft die veröffentlichte SHA-256-Prüfsumme und trägt den Pfad ein. Vorgeschlagen wird die höchste Version der eingetragenen Cluster.

Übersicht und Takt

Ein Takt prüft alle aktiven Cluster parallel, in der Vorgabe jede Minute. Die Übersicht zeigt je Cluster Zustand, Distribution, Version, bereite Nodes und auffällige Pods. Die Seite eines Clusters ergänzt Kapazität, auffällige Nodes und Pods und die letzten Warnungen. Wird ein Cluster unerreichbar oder ein Node nicht bereit, meldet der Takt das als Ereignis.

Was sich ansehen und bedienen lässt

  • Nodes: Rollen, Kubelet, Betriebssystem, Kernel und Runtime, Kapazität und Belegung, Taints und Druck. Sperren (cordon), freigeben und leeren (drain) — das Leeren läuft im Hintergrund, das Ergebnis steht im Verlauf.
  • Pods: Logs je Container, auch vor dem letzten Neustart und mit Filter, dazu describe und YAML. Ein Pod lässt sich neu starten.
  • Workloads: Deployments, StatefulSets und DaemonSets skalieren und per Rollout neu starten. Skalieren geht auch bei Custom Resources mit Scale-Subresource, etwa dem Datenbank-Cluster eines Operators.
  • Jobs: CronJobs sofort ausführen, pausieren und fortsetzen, Läufe ansehen und entfernen.
  • Netzwerk, Speicher, Events: Services und Ingress, PersistentVolumeClaims, Volumes und StorageClasses, Events mit Fokus auf Warnungen.

Für Secrets gibt es weder describe noch YAML: Ihre Werte erscheinen nie in der Oberfläche.

Server hinzufügen

Für einen neuen Server erzeugt das Plugin den fertigen Befehl, der auf dem Server als root ausgeführt wird:

  • k3s: als Agent für Workloads oder als weiterer Server für eine hochverfügbare Control-Plane. Das Cluster-Token kommt aus dem Tresor, die Version entspricht der des Clusters.
  • kubeadm: Das Plugin legt ein befristetes Bootstrap-Token an und zeigt den Beitrittsbefehl mit dem Hash der Cluster-CA einmal an.
  • Systeme mit zypper: Der Befehl bindet die signierte Paketquelle ein, prüft deren Schlüssel am vollen Fingerabdruck, bevor er ihn importiert, und installiert die passende Version. Ist firewalld aktiv, öffnet er die nötigen Ports. Quelle und Fingerabdruck stehen in den Einstellungen.

Bei Clustern der grossen Anbieter legt der Anbieter neue Nodes an; das Plugin zeigt und wartet sie. Ein Node lässt sich auch aus dem Cluster entfernen — zur Bestätigung wird sein Name eingetippt.

Aktionen

Wiederkehrende Handgriffe werden als Aktion festgelegt, etwa ein Datenbank-Status oder eine Wiederherstellung. Eine Aktion führt entweder einen Befehl in passenden Pods aus (Namespace, Label-Selektor, Teil des Pod-Namens, Container) oder startet einen Job aus einem CronJob. Sie ist lesend oder verändernd, hat ein Zeitlimit und verlangt auf Wunsch eine Bestätigung: ein Häkchen oder den eingetippten Namespace. Lesende Aktionen darf ausführen, wer lesen darf; verändernde nur, wer bedienen darf. Aktionen lassen sich als JSON exportieren und auf einer anderen Installation importieren.

Manifeste und Secrets

Zu jedem Cluster lassen sich Manifeste mit Parametern speichern, vergleichen und anwenden. Kubernetes-Secrets entstehen aus Werten im Tresor und lassen sich rotieren. Mehr dazu unter Manifeste und Secrets.

Rechte und Verlauf

Drei Rollen teilen die Arbeit: lesen (Seiten, Logs, Verlauf), bedienen (neu starten, skalieren, Jobs, cordon und drain, Aktionen) und Cluster verwalten (Cluster eintragen, Zugänge, Aktionen festlegen, Server hinzufügen und entfernen). Je Cluster kann zusätzlich ein eigenes Recht zum Lesen oder Ändern verlangt werden; wer es nicht hat, sieht den Cluster nicht. Ausserdem lässt sich ein Cluster auf bestimmte Namespaces beschränken, auch mit Präfix wie team-*. Andere Namespaces sind dann unsichtbar und gesperrt.

Jede verändernde Handlung steht im Verlauf — mit Zeit, Person, Ziel, Ergebnis und dem Weg, auf dem sie kam: Oberfläche, Schnittstelle oder Pipeline. Wie lange der Verlauf aufbewahrt wird, ist einstellbar.

Monitoring, Pipelines und MCP

Für das Monitoring bringt das Plugin ein eigenes Modul mit. Ein Prüfziel je Cluster genügt, dann gibt es Vorfälle für die API, jeden Node sowie Pods und Workloads je Namespace:

Modul:         k8s
Art:           cluster
Konfiguration: {"cluster": "mein-cluster"}

Das Plugin verschickt selbst keine Nachrichten. Es meldet Ereignisse — Cluster erreichbar oder nicht erreichbar, Node neu, entfernt, bereit oder nicht bereit, jede verändernde Handlung —, und Pipelines entscheiden, was geschieht. Umgekehrt stehen Pipeline-Knoten bereit: Zustand lesen, skalieren, Rollout-Neustart, Aktion ausführen, Manifeste vergleichen, anwenden und entfernen, Secrets anwenden und rotieren. Alles ist auch über die REST-Schnittstelle und als MCP-Werkzeuge erreichbar, mit denselben Rechten und Bestätigungen.

Das Plugin ist auf Deutsch, Englisch, Französisch und Italienisch verfügbar. Siehe auch Manifeste und Secrets, Tresor, Monitoring und Pipelines. Zurück zur Übersicht der Plugins.

Kontakt

Fragen zu Kubernetes-Cluster?

Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.