Kubernetes-Befehle: Die wichtigsten kubectl-Befehle im Überblick

Mon, 02 Nov 2026 00:00:00 +0000

Mit kubectl steuerst du deinen Kubernetes-Cluster von der Kommandozeile aus. Hier stehen die Befehle, die man im Alltag immer wieder braucht, nach Themen sortiert.

Fast alle Befehle wirken im aktuellen Namespace. Mit -n name arbeitest du in einem anderen Namespace, mit -A siehst du alle auf einmal.

Cluster und Kontext
#

Befehl	Beschreibung
`kubectl cluster-info`	Zeigt, mit welchem Cluster du verbunden bist.
`kubectl get nodes -o wide`	Listet alle Nodes mit IP-Adresse und Version auf.
`kubectl config get-contexts`	Zeigt alle eingerichteten Cluster-Verbindungen.
`kubectl config use-context name`	Wechselt zu einem anderen Cluster.
`kubectl version`	Zeigt die Version von kubectl und vom Cluster.

Namespaces
#

Befehl	Beschreibung
`kubectl get namespaces`	Listet alle Namespaces auf.
`kubectl create namespace test`	Legt einen neuen Namespace an.
`kubectl config set-context --current --namespace=test`	Macht `test` zum Standard-Namespace, damit du nicht jedes Mal `-n` schreiben musst.

Pods
#

Pods anzeigen
#

Befehl	Beschreibung
`kubectl get pods`	Listet die Pods im aktuellen Namespace auf.
`kubectl get pods -A`	Listet alle Pods in allen Namespaces auf.
`kubectl get pods -o wide`	Zeigt zusätzlich IP-Adresse und Node jedes Pods.
`kubectl get pods -w`	Beobachtet die Pods live. Beenden mit Strg+C.

Mit Pods arbeiten
#

Befehl	Beschreibung
`kubectl describe pod name`	Zeigt alle Details und die letzten Ereignisse eines Pods. Bei Problemen der erste Blick.
`kubectl logs name`	Zeigt die Logs eines Pods.
`kubectl logs name -f`	Verfolgt die Logs live.
`kubectl logs name --previous`	Zeigt die Logs des abgestürzten Vorgängers. Gold wert bei `CrashLoopBackOff`.
`kubectl exec -it name -- sh`	Öffnet eine Shell im Pod.
`kubectl delete pod name`	Löscht einen Pod. Gehört er zu einem Deployment, startet sofort ein neuer.

Deployments
#

Befehl	Beschreibung
`kubectl get deployments`	Listet alle Deployments auf.
`kubectl create deployment web --image=nginx`	Legt ein Deployment mit einem Image an.
`kubectl set image deployment/web nginx=nginx:1.27`	Aktualisiert das Image eines Deployments.
`kubectl rollout status deployment/web`	Verfolgt, ob ein Update erfolgreich durchläuft.
`kubectl rollout restart deployment/web`	Startet alle Pods eines Deployments nacheinander neu.
`kubectl rollout undo deployment/web`	Macht das letzte Update rückgängig.

Pods skalieren
#

Manuell skalieren
#

Befehl	Beschreibung
`kubectl scale deployment web --replicas=5`	Setzt die Anzahl der Pods auf genau 5.
`kubectl scale deployment web --replicas=0`	Fährt alle Pods herunter, ohne das Deployment zu löschen.
`kubectl get deployment web`	Zeigt, wie viele Pods gewünscht und wie viele bereit sind.

Automatisch skalieren
#

Befehl	Beschreibung
`kubectl autoscale deployment web --min=2 --max=10 --cpu-percent=70`	Startet zwischen 2 und 10 Pods, je nachdem, ob die CPU-Auslastung über oder unter 70 Prozent liegt.
`kubectl get hpa`	Zeigt alle automatischen Skalierungen mit aktueller Auslastung.
`kubectl describe hpa web`	Zeigt Details und wann zuletzt skaliert wurde.
`kubectl delete hpa web`	Schaltet das automatische Skalieren wieder ab.

Das automatische Skalieren braucht den Metrics Server im Cluster und CPU-Requests in deinem Deployment. Ohne sie zeigt kubectl get hpa bei der Auslastung nur unknown. Läuft eine automatische Skalierung, überschreibt sie außerdem jedes manuelle kubectl scale.

Services und Netzwerk
#

Befehl	Beschreibung
`kubectl get services`	Listet alle Services auf.
`kubectl expose deployment web --port=80 --type=ClusterIP`	Macht ein Deployment im Cluster unter einem festen Namen erreichbar.
`kubectl get ingress`	Listet alle Ingress-Regeln auf, also die Weiterleitungen von außen.
`kubectl port-forward svc/web 8080:80`	Leitet einen Port auf deinen Rechner weiter. Ideal zum Testen ohne Ingress.

Konfiguration und Secrets
#

Befehl	Beschreibung
`kubectl get configmaps`	Listet alle ConfigMaps auf.
`kubectl get secrets`	Listet alle Secrets auf.
`kubectl create secret generic db --from-literal=password=geheim`	Legt ein Secret mit einem Wert an.

Secrets sind in Kubernetes standardmäßig nur Base64-kodiert und nicht verschlüsselt. Jeder mit Leserechten im Namespace kann sie auslesen. Vergib die Rechte deshalb sparsam.

Manifeste anwenden
#

Befehl	Beschreibung
`kubectl apply -f datei.yaml`	Legt Ressourcen aus einer Datei an oder aktualisiert sie.
`kubectl apply -f ordner/`	Wendet alle Dateien in einem Ordner an.
`kubectl diff -f datei.yaml`	Zeigt vorher, was sich ändern würde.
`kubectl delete -f datei.yaml`	Löscht alle Ressourcen aus der Datei.
`kubectl get deployment web -o yaml`	Zeigt die komplette Konfiguration einer Ressource als YAML.

Fehlersuche
#

Befehl	Beschreibung
`kubectl get events --sort-by=.lastTimestamp`	Zeigt die letzten Ereignisse im Namespace, sortiert nach Zeit.
`kubectl top nodes`	Zeigt CPU- und RAM-Auslastung der Nodes. Braucht den Metrics Server.
`kubectl top pods`	Zeigt die Auslastung der Pods.
`kubectl get all`	Zeigt Pods, Deployments, Services und mehr auf einen Blick.

Die häufigsten Pod-Zustände und was sie bedeuten:

Kubernetes on Patrick Adams

Kubernetes-Befehle: Die wichtigsten kubectl-Befehle im Überblick

Cluster und Kontext #

Namespaces #

Pods #

Pods anzeigen #

Mit Pods arbeiten #

Deployments #

Pods skalieren #

Manuell skalieren #

Automatisch skalieren #

Services und Netzwerk #

Konfiguration und Secrets #

Manifeste anwenden #

Fehlersuche #