kubectl 1.37 reference · Workloads
kubectl rollout Command (kubectl)
Manage Deployment, StatefulSet and DaemonSet rollouts: watch status, view history, restart and undo to a previous revision.
kubectl 1.37
Syntax
kubectl rollout status|history|restart|undo|pause|resume RESOURCE/NAME
Parameters
| Parameter | Description |
|---|---|
status |
Wait for the rollout to finish (--timeout). |
undo |
Roll back to the previous (or --to-revision) revision. |
restart |
Restart all pods with a new rollout. |
history |
List revisions. |
Examples
kubectl create namespace rc-ref-roll > /dev/null
trap 'kubectl delete namespace rc-ref-roll --wait=false > /dev/null' EXIT
kubectl -n rc-ref-roll create deployment api --image=busybox:1.37 -- sleep 3600 > /dev/null
kubectl -n rc-ref-roll rollout status deployment/api --timeout=120s | tail -1
kubectl -n rc-ref-roll set image deployment/api busybox=busybox:1.37-musl > /dev/null
kubectl -n rc-ref-roll rollout status deployment/api --timeout=120s > /dev/null
kubectl -n rc-ref-roll rollout undo deployment/api
kubectl -n rc-ref-roll rollout status deployment/api --timeout=120s > /dev/null
kubectl -n rc-ref-roll get deployment api -o jsonpath='image now: {.spec.template.spec.containers[0].image}{"\n"}'
Output
deployment "api" successfully rolled out deployment.apps/api rolled back image now: busybox:1.37
Run this on your computer — see “Get Started” for setup.
kubectl create namespace rc-ref-roll2 > /dev/null
trap 'kubectl delete namespace rc-ref-roll2 --wait=false > /dev/null' EXIT
kubectl -n rc-ref-roll2 create deployment api --image=busybox:1.37 -- sleep 3600 > /dev/null
kubectl -n rc-ref-roll2 rollout status deployment/api --timeout=120s > /dev/null
kubectl -n rc-ref-roll2 rollout restart deployment/api
kubectl -n rc-ref-roll2 rollout status deployment/api --timeout=120s > /dev/null
echo "revisions: $(kubectl -n rc-ref-roll2 rollout history deployment/api | grep -cE '^[0-9]')"
Output
deployment.apps/api restarted revisions: 2
Run this on your computer — see “Get Started” for setup.
Related
kubectl set image· Change the image of one or more containers in a workload's pod template, which starts a rolling update.kubectl scale· Set the number of replicas of a Deployment, ReplicaSet or StatefulSet; avoid it for workloads managed by an autoscaler.- Rolling Updates and Rollbacks · tutorial