diff --git a/docs/user-guide/deployments.md b/docs/user-guide/deployments.md index 7610384eab..a7ac2d2fdb 100644 --- a/docs/user-guide/deployments.md +++ b/docs/user-guide/deployments.md @@ -80,61 +80,6 @@ The created Replica Set will ensure that there are three nginx Pods at all times **Note:** You must specify appropriate selector and pod template labels of a Deployment (in this case, `app = nginx`), i.e. don't overlap with other controllers (including Deployments, Replica Sets, Replication Controllers, etc.) Kubernetes won't stop you from doing that, and if you end up with multiple controllers that have overlapping selectors, those controllers will fight with each other's and won't behave correctly. -## The Status of a Deployment - -After creating or updating a Deployment, you would want to confirm whether it succeeded or not. The simplest way to do this is through `kubectl rollout status`. - -```shell -$ kubectl rollout status deployment/nginx-deployment -deployment "nginx-deployment" successfully rolled out -``` - -This verifies the Deployment's `.status.observedGeneration` >= `.metadata.generation`, and its up-to-date replicas -(`.status.updatedReplicas`) matches the desired replicas (`.spec.replicas`) to determine if the rollout succeeded. -It also expects that the available replicas running (`.spec.availableReplicas`) will be at least the minimum required -based on the Deployment strategy. If the rollout is still in progress, it watches for Deployment status changes and -prints related messages. - -```shell -$ kubectl rollout status deployment/nginx-deployment -Waiting for rollout to finish: 2 out of 10 new replicas have been updated... -Waiting for rollout to finish: 2 out of 10 new replicas have been updated... -Waiting for rollout to finish: 2 out of 10 new replicas have been updated... -Waiting for rollout to finish: 3 out of 10 new replicas have been updated... -Waiting for rollout to finish: 3 out of 10 new replicas have been updated... -Waiting for rollout to finish: 4 out of 10 new replicas have been updated... -Waiting for rollout to finish: 4 out of 10 new replicas have been updated... -Waiting for rollout to finish: 4 out of 10 new replicas have been updated... -Waiting for rollout to finish: 4 out of 10 new replicas have been updated... -Waiting for rollout to finish: 4 out of 10 new replicas have been updated... -Waiting for rollout to finish: 5 out of 10 new replicas have been updated... -Waiting for rollout to finish: 5 out of 10 new replicas have been updated... -Waiting for rollout to finish: 5 out of 10 new replicas have been updated... -Waiting for rollout to finish: 5 out of 10 new replicas have been updated... -Waiting for rollout to finish: 6 out of 10 new replicas have been updated... -Waiting for rollout to finish: 6 out of 10 new replicas have been updated... -Waiting for rollout to finish: 6 out of 10 new replicas have been updated... -Waiting for rollout to finish: 6 out of 10 new replicas have been updated... -Waiting for rollout to finish: 6 out of 10 new replicas have been updated... -Waiting for rollout to finish: 7 out of 10 new replicas have been updated... -Waiting for rollout to finish: 7 out of 10 new replicas have been updated... -Waiting for rollout to finish: 7 out of 10 new replicas have been updated... -Waiting for rollout to finish: 7 out of 10 new replicas have been updated... -Waiting for rollout to finish: 8 out of 10 new replicas have been updated... -Waiting for rollout to finish: 8 out of 10 new replicas have been updated... -Waiting for rollout to finish: 8 out of 10 new replicas have been updated... -Waiting for rollout to finish: 9 out of 10 new replicas have been updated... -Waiting for rollout to finish: 9 out of 10 new replicas have been updated... -Waiting for rollout to finish: 9 out of 10 new replicas have been updated... -Waiting for rollout to finish: 1 old replicas are pending termination... -Waiting for rollout to finish: 1 old replicas are pending termination... -Waiting for rollout to finish: 1 old replicas are pending termination... -Waiting for rollout to finish: 9 of 10 updated replicas are available... -deployment "nginx-deployment" successfully rolled out -``` - -For more information about the status of a Deployment [read more here](#deployment-status). - ## Updating a Deployment