Watch a deployment rollout with an explicit timeout
Build a paste-ready command, then review its compatibility and effects before running it.
kubectl rollout status deployment/<deployment> -n <namespace> --timeout=<seconds>sComplete required fields to copy the generated command.
Compatibility
Linux + macOS + WindowsVerified for Linux, macOS, Windows using bash, zsh, powershell syntax.
Operational knowledgereview due 2027-01-19
Requirementskubectlkubectl must be installed and available on PATH.Network accessThe target must be reachable from the current environment.
Version supportkubectl Current supported releasesVerified for linux, macos, windows using bash, zsh, powershell syntax; consult compatibility notes for platform-specific differences.
Expected signalsWaiting for deployment "api" rollout to finish: 2 of 4 updated replicas are available...Representative successful output; values vary with the selected target and system state.
Known errorskubectl: command not foundkubectl is missing or is not available on PATH.
Verifykubectl rollout status deployment/{{deployment}} -n {{namespace}} --timeout={{seconds}}sThe output matches the expected target and exits without an error.Rollback noteNot required: this command is read-only and does not change system state.
Command breakdown
01kubectlCommandRuns the kubectl stage of this one-liner.
02rolloutArgumentPasses rollout to kubectl.
03statusArgumentPasses status to kubectl.
04deployment/<deployment>ParameterA value supplied in the Fill parameters section.
05-nOptionApplies the command-specific numeric, dry-run, or non-resolving mode.
06<namespace>ParameterA value supplied in the Fill parameters section.
07--timeout=<seconds>sOptionConfigures kubectl with the --timeout=<seconds>s option.
This advanced community-curated one-liner combines several stages. Review every option and placeholder before running it.
Example input
kubectl rollout status deployment/api -n production --timeout=180s
Example output
Waiting for deployment "api" rollout to finish: 2 of 4 updated replicas are available...
deployment "api" successfully rolled out
Illustrative output — exact values vary by system and data.
Official sources