Zum Inhalt

kubectl delete

Löscht Objekte aus dem Cluster, nach Name, nach Label oder so, wie sie in einem Manifest beschrieben sind.

kubectl-delete output

Syntax

kubectl delete TYP NAME | -f DATEI | -l LABEL [OPTIONEN]

Optionen

Option Beschreibung
TYP NAME Etwa pod broken oder deployment hello
-f DATEI Alles löschen, was das Manifest beschreibt
-l LABEL=WERT Alle Objekte mit diesem Label
-n NAMESPACE Namespace der Objekte
--dry-run=client Nur zeigen, was gelöscht würde
--grace-period=0 --force Einen hängenden Pod sofort löschen

Beispiele

Ein Deployment löschen:

kubectl delete deployment hello -n status
deployment.apps "hello" deleted from status namespace

Einen Pod ersetzen lassen:

kubectl delete pod web-9bc5f7f5b-8ptw2 -n status
kubectl get pods -n status
pod "web-9bc5f7f5b-8ptw2" deleted from status namespace
NAME                  READY   STATUS    RESTARTS   AGE
web-9bc5f7f5b-m8l96   1/1     Running   0          2h
web-9bc5f7f5b-q4zxn   1/1     Running   0          3s

Erst prüfen, was gelöscht würde:

kubectl delete -f ~/k8s/status.yaml --dry-run=client
namespace "status" deleted (dry run)
deployment.apps "web" deleted (dry run)
service "web" deleted (dry run)
ingress.networking.k8s.io "web" deleted (dry run)

Einen Namespace mit allem darin entfernen:

kubectl delete namespace monitoring
namespace "monitoring" deleted

Wann brauche ich das?

  • Um Testobjekte und Anwendungen zu entfernen, die du nicht mehr brauchst
  • Um einen hängenden Pod ersetzen zu lassen: Das Deployment startet sofort einen neuen
  • Um eine ganze Anwendung samt Namespace zu entfernen

Einen Pod löschen heißt ihn neu starten

Ein Pod, der zu einem Deployment gehört, wird nach kubectl delete pod sofort neu angelegt. So startest du schnell einen einzelnen Pod neu. Für alle Pods nimm kubectl rollout restart.

Ein Namespace nimmt alles mit

kubectl delete namespace NAME löscht jedes Objekt darin, auch Secrets und Volumes samt Daten, ohne Rückfrage.

Verwandte Befehle

kubectl apply · kubectl create · kubectl rollout · kubectl get