Kubernetes Runbooks

Pod lifecycle, scheduling, networking, storage, and control-plane failures.

35 scenarios · search and filter below, or jump via the quick nav.

Intermediate16 runbooks
Pods stuck in Pending state — unschedulablehigh

kubectl get pods shows Pending for minutes

KubernetesIntermediate3 causes
1Open runbook
DNS resolution failing inside pods — CoreDNS issuescritical

curl: Could not resolve host inside pods

KubernetesIntermediate2 causes
2Open runbook
Service not routing traffic — no endpointshigh

curl to Service IP returns connection refused

KubernetesIntermediate2 causes
3Open runbook
Deployment rollout stuck — progress deadline exceededhigh

kubectl rollout status hangs on 'Waiting for rollout to finish'

KubernetesIntermediate2 causes
4Open runbook
Service LoadBalancer stuck Pending — no external IPhigh

kubectl get svc shows <pending> for EXTERNAL-IP

KubernetesIntermediate2 causes
5Open runbook
Ingress returns 404/502 — backend service unresolvedmedium

curl to the Ingress host returns 404 Not Found or 502

KubernetesIntermediate3 causes
6Open runbook
Container exits immediately with exit code 0 — entrypoint daemonizes or returnshigh

Pod restarts repeatedly with exit code 0 and status Completed

KubernetesIntermediate2 causes
7Open runbook
imagePullPolicy Always + immutable tag — pull fails after registry changehigh

New pods fail to pull image after a rollout, even though the tag exists

KubernetesIntermediate3 causes
8Open runbook
metrics-server missing or down — kubectl top fails with no metrics knownmedium

kubectl top pods returns error: metrics not available

KubernetesIntermediateUSE3 causes
9Open runbook
Pod container binds host port — address already in usehigh

Pod in CrashLoopBackOff with bind: address already in use

KubernetesIntermediate2 causes
10Open runbook
Liveness and readiness probes fighting — healthy app killed repeatedlyhigh

Pod restarts repeatedly but application logs show no errors

KubernetesIntermediate3 causes
11Open runbook
ResourceQuota / LimitRange exceeded — FailedCreate, pods rejectedhigh

Events show quota exceeded or limit range exceeded when creating pods

KubernetesIntermediate3 causes
12Open runbook
RBAC Forbidden — serviceaccount cannot access API resourceshigh

kubectl logs show 'Error from server (Forbidden): pods is forbidden'

KubernetesIntermediate3 causes
13Open runbook
NodePort not reachable externally — cloud firewall or security group blockinghigh

NodePort service works internally but not from outside the cluster

KubernetesIntermediate3 causes
14Open runbook
CronJob not running — suspended, schedule mismatch, or timezone issuehigh

No new Jobs created for a CronJob past its scheduled time

KubernetesIntermediate3 causes
15Open runbook
DaemonSet pods not scheduled on expected nodes — selector or affinity mismatchhigh

DaemonSet desiredNumberScheduled < number of eligible nodes

KubernetesIntermediate3 causes
16Open runbook
Advanced11 runbooks
Worker node NotReady — node down or kubelet failurecritical

kubectl get nodes shows NotReady for one or more workers

KubernetesAdvancedUSE3 causes
1Open runbook
PersistentVolumeClaim stuck in Pending — no provisionerhigh

kubectl get pvc shows Pending

KubernetesAdvanced2 causes
2Open runbook
Pods evicted — node pressure (disk, memory, pid)high

Terminating/Evicted pod states on nodes

KubernetesAdvancedUSE3 causes
3Open runbook
High CPU throttling — containers starved by CPU limitsmedium

High response latency with low CPU saturation on the node

KubernetesAdvancedUSE2 causes
4Open runbook
HorizontalPodAutoscaler unable to fetch metrics — HPA not scalinghigh

HPA currentMetrics shows <unknown> or targets stuck at 0%

KubernetesAdvancedUSE3 causes
5Open runbook
Namespace stuck in Terminating — finalizers blocking deletionmedium

kubectl get namespace shows Terminating for minutes or hours

KubernetesAdvanced3 causes
6Open runbook
PersistentVolume stuck in Released state — reclaim not happeninghigh

kubectl get pv shows status Released for extended period

KubernetesAdvanced3 causes
7Open runbook
Service ClusterIP unreachable — kube-proxy stale iptables or conntrackhigh

curl to ClusterIP from a pod returns connection refused or timeout

KubernetesAdvanced3 causes
8Open runbook
conntrack table full — connections silently dropped, services failingcritical

Intermittent connection timeouts to ClusterIP services

KubernetesAdvancedUSE3 causes
9Open runbook
StatefulSet stuck — ordered readiness, PVC pending, or headless service issuehigh

StatefulSet pods stuck in Pending or ContainerCreating sequentially

KubernetesAdvanced3 causes
10Open runbook
PV reclaim slow or stuck — controller not picking up Released volumeshigh

PV stays in Released state for hours after PVC deletion

KubernetesAdvanced3 causes
11Open runbook