Zum Inhalt

kubectl apply

Legt Objekte aus Manifest-Dateien an oder aktualisiert sie, damit der Cluster dem entspricht, was die Dateien beschreiben.

kubectl-apply output

Syntax

kubectl apply -f DATEI|VERZEICHNIS|URL [OPTIONEN]

Optionen

Option Beschreibung
-f DATEI Manifest-Datei, ein Verzeichnis oder eine URL; -f - liest von der Standardeingabe
-R, --recursive Auch die Unterverzeichnisse eines Verzeichnisses lesen
-k VERZEICHNIS Ein Kustomize-Verzeichnis anwenden
--dry-run=server Den Server alles prüfen lassen, ohne etwas zu ändern
--prune -l LABEL Objekte mit diesem Label löschen, die nicht mehr in den Dateien stehen

kubectl diff -f DATEI zeigt vorher, was apply ändern würde.

Beispiele

Die Statusseite ausrollen:

kubectl apply -f ~/k8s/status.yaml
namespace/status created
deployment.apps/web created
service/web created
ingress.networking.k8s.io/web created

Die Datei steht in den Grundlagen.

Ohne Änderungen erneut anwenden:

kubectl apply -f ~/k8s/status.yaml
namespace/status unchanged
deployment.apps/web unchanged
service/web unchanged
ingress.networking.k8s.io/web unchanged

Eine Änderung vor dem Anwenden ansehen:

sed -i 's/replicas: 2/replicas: 3/' ~/k8s/status.yaml
kubectl diff -f ~/k8s/status.yaml
diff -u -N /tmp/LIVE-1873412233/apps.v1.Deployment.status.web /tmp/MERGED-2201857604/apps.v1.Deployment.status.web
--- /tmp/LIVE-1873412233/apps.v1.Deployment.status.web  2026-10-26 10:42:17.000000000 +0100
+++ /tmp/MERGED-2201857604/apps.v1.Deployment.status.web  2026-10-26 10:42:17.000000000 +0100
@@ -6,7 +6,7 @@
   name: web
   namespace: status
 spec:
   progressDeadlineSeconds: 600
-  replicas: 2
+  replicas: 3
   revisionHistoryLimit: 10
   selector:
     matchLabels:

Ein ganzes Verzeichnis anwenden:

kubectl apply -R -f ~/k8s/
namespace/status unchanged
deployment.apps/web configured
service/web unchanged
ingress.networking.k8s.io/web unchanged
configmap/web-config created

Wann brauche ich das?

  • Um eine in YAML-Dateien beschriebene Anwendung auszurollen
  • Nach jeder Änderung an einem Manifest, etwa einer neuen Image-Version oder mehr Replikaten
  • In Git-basierten Abläufen, in denen die Manifeste im Repository die Wahrheit sind

Manifeste in Git

Leg deine Manifeste in ein Git-Repository und ändere den Cluster nur mit kubectl apply. Dann zeigt der Verlauf jede Änderung, und ein Cluster lässt sich jederzeit aus den Dateien neu aufbauen.

Handänderungen werden überschrieben

Was du mit kubectl edit oder kubectl scale geändert hast, setzt das nächste kubectl apply wieder auf den Stand der Datei zurück. Ändere lieber die Datei.

Verwandte Befehle

kubectl create · kubectl delete · kubectl rollout · git diff