Kubernetes
Quelle: pkr-lab/pkr-lab-docs/cubi/kubernetes.md
Kubernetes
Pods, Nodes und Warnungen ansehen, Namespace und Kontext wechseln.
Code: modules/kube.py (alle Aufrufe gehen über kubectl)
Überblick
cubi kubernetes (k8s, kubectl) arbeitet mit dem aktuellen kubectl-Kontext und -Namespace. Den Cluster der Homelab-Umgebung beschreibt k3s.
| Eintrag | Befehl | Inhalt |
|---|---|---|
| Pods | kubectl get pods [-n <ns>\|-A] -o json |
Tabelle, alle 10 Sekunden neu |
| Nodes | kubectl get nodes -o json |
Tabelle, alle 15 Sekunden neu |
| Warnungen | kubectl get events -A --field-selector type=Warning --sort-by=.lastTimestamp |
einmalige Ausgabe |
| Namespace wechseln | kubectl config set-context --current --namespace=<ns> |
schreibt in die kubeconfig |
| Kontext wechseln | kubectl config use-context <name> |
schreibt in die kubeconfig |
Namespace und Kontext stehen als Hinweis im Menü (aktuell: …). Der Wechsel gilt auch außerhalb von cubi, weil er die kubeconfig ändert.
Pods
Spalten: (Namespace bei „alle Namespaces“), Pod, Ready (2/3), Status, Restarts, Alter, Node. Mit a schaltet man zwischen aktuellem Namespace und allen Namespaces um.
Der Status wird wie bei kubectl get pods aus mehreren Feldern abgeleitet (pod_status): Terminating bei gesetztem deletionTimestamp, Init:<Grund> bei wartenden oder fehlgeschlagenen Init-Containern, sonst der Grund des wartenden oder beendeten Containers (CrashLoopBackOff, ImagePullBackOff, OOMKilled, …), sonst die Phase.
| Farbe | Bedeutung |
|---|---|
| grün | Running und alle Container bereit |
| gelb | Running, aber nicht alle bereit; Pending, ContainerCreating, Terminating, PodInitializing, Init:… |
| grau | Completed, Succeeded |
| rot | alles andere (Error, CrashLoopBackOff, ImagePullBackOff, Failed, …) |
Die Zusammenfassung zählt „N Pods · M mit Auffälligkeiten“ (rot oder gelb). Ein Pod-Menü bietet:
| Aktion | Befehl |
|---|---|
| Logs | kubectl logs -n <ns> <pod> --all-containers=true --tail=300 |
| Logs folgen | kubectl logs -f … --tail=100, Abbruch mit Strg+C |
| Describe | kubectl describe pod -n <ns> <pod> |
| Shell | kubectl exec -it … -- sh -c 'command -v bash … && exec bash \|\| exec sh' |
| Löschen | kubectl delete pod nach Rückfrage |
Löschen ist die einzige zerstörende Aktion. Bei Pods, die ein Deployment oder StatefulSet verwaltet, startet Kubernetes den Pod neu.
Nodes
Spalten: Node, Status (Ready grün, NotReady rot), Rollen (aus node-role.kubernetes.io/*), Version, interne IP, Alter. Enter zeigt kubectl describe node. Zum Cluster-Aufbau siehe k3s und Cluster Power Manager (Worker werden nachts heruntergefahren, NotReady ist dann erwartbar).
Debugging und Fehlersuche
Ladefehler erscheinen in der Tabelle als rote Zeile ✖ <Meldung>. Mit r lädt man neu, die Tasten funktionieren weiter.
| Meldung | Ursache | Lösung |
|---|---|---|
kubectl ist nicht installiert oder nicht im PATH |
kubectl fehlt |
installieren |
The connection to the server … was refused / Unable to connect to the server |
falscher Kontext, Cluster aus, VPN fehlt | kubectl config current-context, im Bereich Kontext wechseln korrigieren, Tailscale prüfen |
error: You must be logged in to the server (Unauthorized) |
Zertifikat oder Token der kubeconfig abgelaufen | kubeconfig erneuern |
Error from server (Forbidden): pods is forbidden … |
keine Rechte im Namespace | anderen Namespace oder Kontext wählen, RBAC prüfen |
Zeitüberschreitung bei: kubectl get pods … |
API-Server langsam oder nicht erreichbar (Timeout 30 Sekunden) | Verbindung testen, kubectl get --raw /readyz |
Ungültige Ausgabe von: kubectl … |
Ausgabe war kein JSON (zum Beispiel Warnung vor dem JSON) | Befehl mit -o json direkt ausführen |
Keine Kontexte gefunden |
kubeconfig leer | KUBECONFIG prüfen |
Kontext konnte nicht gesetzt werden, Namespace konnte nicht gesetzt werden |
kubeconfig nicht schreibbar oder Name ungültig | Rechte der kubeconfig prüfen |
Keine Einträge vorhanden |
zum Beispiel Namespaceliste leer | Kontext prüfen |
Tabelle zeigt Keine Einträge |
im Namespace laufen keine Pods | a für alle Namespaces |
| Pod-Shell endet sofort | Image ohne sh (distroless) |
kubectl debug außerhalb von cubi |
Logs meldet Keine Logs |
Container noch nicht gestartet | Describe → Events lesen |
Typische Pod-Fehlerbilder aus der Statusspalte:
| Status | Ursache | Weiter |
|---|---|---|
CrashLoopBackOff |
Container startet und beendet sich | Logs (bei Neustarts: kubectl logs --previous), Describe → Exit-Code |
ImagePullBackOff / ErrImagePull |
Image oder Tag fehlt, Registry nicht erreichbar | Describe → Events, Image-Name und Pull-Secret prüfen |
Pending |
keine passende Node, PVC nicht gebunden | Describe → Events (FailedScheduling), Node-Status im Bereich Nodes prüfen |
OOMKilled |
Speicherlimit überschritten | Limits im Chart, siehe HPA und Ressourcen |
Init:Error |
Init-Container fehlgeschlagen | kubectl logs <pod> -c <init-container> |
Checkliste „Pod läuft nicht“:
- Bereich Nodes: alle
Ready? - Pod-Menü → Describe, unten bei Events.
- Logs, bei Neustart zusätzlich
--previous. - Warnungen: gibt es clusterweit Events?
- Zum Dienst gehörende Doku, zum Beispiel Dienste-Übersicht in capulus-core.
Allgemeines: Debugging und Fehlersuche.