Course contentsShow
← Cloud and Infrastructure
Lesson 1172 of 2,98923. Kubernetes WorkloadsFree lesson

Deployment Progress Deadline

Set progressDeadlineSeconds to define how long Kubernetes waits for a rollout to progress before marking it failed.

Deployment Progress Deadline

What you'll learn: How to configure a time limit for Kubernetes Deployments to complete their rollout before being marked as failed.

The Problem: Stuck Rollouts

When you update a Deployment, Kubernetes begins a rolling update to replace old Pods with new ones. But what happens if this process stalls? Maybe a new Pod can't pull its image, or it keeps crashing due to a misconfigured health check. Without a deadline, Kubernetes might keep trying indefinitely, leaving your deployment in limbo.

Setting progressDeadlineSeconds

The progressDeadlineSeconds field tells Kubernetes: "If this rollout doesn't make meaningful progress within X seconds, mark it as failed." By default, this is set to 600 seconds (10 minutes).

"Progress" means creating at least one new Pod successfully. If the Deployment can't achieve this within the deadline, it reports a failure condition, alerting you that something's wrong.

Think of it like this: You order food delivery with a 30-minute guarantee. If the driver makes no progress toward your address in 30 minutes, the system alerts you there's a problem. Similarly, progressDeadlineSeconds is your rollout's timeout guarantee.

How to Configure It

In your Deployment manifest, add it to the spec section:

spec:
  progressDeadlineSeconds: 300  # 5 minutes
  replicas: 3
  # ... rest of deployment spec

Why This Matters

Setting an appropriate deadline helps you:

  • Detect failed rollouts quickly rather than waiting indefinitely
  • Trigger alerts when deployments aren't progressing
  • Prevent resource waste from continuously retrying impossible updates

Key Takeaway: progressDeadlineSeconds defines how long Kubernetes waits for a rollout to show progress before marking it failed, helping you catch and respond to deployment problems faster.