LinuxCommandLibrary

kubectl-rollout

manages deployment rollouts

TLDR

Check rollout status

$ kubectl rollout status deployment/[name]
copy
View rollout history
$ kubectl rollout history deployment/[name]
copy
Undo rollout
$ kubectl rollout undo deployment/[name]
copy
Rollback to revision
$ kubectl rollout undo deployment/[name] --to-revision=[2]
copy
Pause rollout
$ kubectl rollout pause deployment/[name]
copy
Resume rollout
$ kubectl rollout resume deployment/[name]
copy
Restart rollout
$ kubectl rollout restart deployment/[name]
copy

SYNOPSIS

kubectl rollout command [options] resource

DESCRIPTION

kubectl rollout manages the lifecycle of rolling updates for Kubernetes workloads including deployments, daemon sets, and stateful sets. It provides subcommands to monitor the progress of an ongoing rollout, inspect revision history, and trigger rollbacks to previous versions when issues are detected.
The command also supports pausing and resuming rollouts, which is useful for performing canary-style deployments where you want to verify a partial update before allowing it to proceed. The `restart` subcommand triggers a new rolling restart of all pods without changing the pod template, which is helpful for picking up ConfigMap or Secret changes. Each rollout is tracked as a numbered revision, enabling precise rollbacks with --to-revision.

PARAMETERS

status RESOURCE

Check rollout status.
history RESOURCE
View revision history.
undo RESOURCE
Rollback to previous.
pause RESOURCE
Pause rollout.
resume RESOURCE
Resume paused rollout.
restart RESOURCE
Trigger rolling restart.
--to-revision N
Target revision.
--help
Display help information.

CAVEATS

Subcommand of kubectl. Works with deployments, statefulsets. Revision history has limits.

HISTORY

kubectl rollout provides rollout management for Kubernetes deployment lifecycle operations.

SEE ALSO

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community