How to Check Rollout Status in Kubernetes Quickly
Use the
kubectl rollout status command followed by the resource type and name to check the rollout status in Kubernetes. For example, kubectl rollout status deployment/my-app shows the current state of the deployment rollout.Syntax
The basic syntax to check rollout status is:
kubectl rollout status <resource-type>/<resource-name>
Here, resource-type can be deployment, daemonset, or statefulset. resource-name is the name of your Kubernetes resource.
bash
kubectl rollout status deployment/my-deployment
Example
This example shows how to check the rollout status of a deployment named nginx-deployment. It helps you see if the new version is successfully updated or still in progress.
bash
kubectl rollout status deployment/nginx-deployment
Output
deployment "nginx-deployment" successfully rolled out
Common Pitfalls
Common mistakes include:
- Using the wrong resource type (e.g.,
podinstead ofdeployment). - Misspelling the resource name.
- Not having the correct context or permissions to access the cluster.
Always verify the resource type and name with kubectl get deployments before checking rollout status.
bash
kubectl rollout status pod/nginx-pod
# Wrong resource type
kubectl rollout status deployment/nginx-deployment
# Correct usageQuick Reference
| Command | Description |
|---|---|
| kubectl rollout status deployment/ | Check rollout status of a deployment |
| kubectl rollout status daemonset/ | Check rollout status of a daemonset |
| kubectl rollout status statefulset/ | Check rollout status of a statefulset |
| kubectl get deployments | List all deployments to verify names |
| kubectl rollout undo deployment/ | Rollback to previous deployment version |
Key Takeaways
Use
kubectl rollout status with the correct resource type and name to check rollout progress.Verify resource names with
kubectl get deployments before checking status.Common errors include wrong resource type or misspelled names.
Rollout status shows if the update is complete or still in progress.
You can rollback a deployment using
kubectl rollout undo if needed.