unschedulable
The state of a pod that the scheduler cannot place on any node, which leaves it Pending with a FailedScheduling event explaining why.
In more detail
The event message counts how many nodes failed each check, such as insufficient memory, an untolerated taint or an unmatched affinity rule. Fix the constraint or add capacity; retrying does not help. A Scheduled event proves placement finished, though not that the pod is ready.
Example
kubectl describe pod web | sed -n '/Events:/,$p'Related terms
- kube-scheduler — The part of Kubernetes that decides which machine each new pod runs on.
- pod phase — A one-word summary of where a pod is in its life: Pending, Running, Succeeded, Failed or Unknown.
- node affinity — Rules in a pod spec that say which nodes the pod must run on, or would prefer, based on node labels such as zone or hardware.
- taint — A mark on a node that repels pods which do not tolerate it, used to reserve nodes or keep work off unhealthy ones.
- allocatable capacity — The share of a node's CPU and memory available to pods after space is reserved for the operating system and Kubernetes itself.
Taught in
- Who Owns The Symptom: Control Plane And Nodes — Kubernetes and Cloud Native Associate (KCNA) Exam Prep
- Pending All Saturday: How The Scheduler Places Pods — Kubernetes and Cloud Native Associate (KCNA) Exam Prep
- Fundamentals Sprint: Four Tickets Before The Doors Open — Kubernetes and Cloud Native Associate (KCNA) Exam Prep
- The Status Tells You Where To Look: Troubleshooting Pods — Kubernetes and Cloud Native Associate (KCNA) Exam Prep
- Six Times The Traffic: Autoscaling Pods And Nodes — Kubernetes and Cloud Native Associate (KCNA) Exam Prep
- The Festival, End To End: Final Review — Kubernetes and Cloud Native Associate (KCNA) Exam Prep
- The Report That Ate The Node: Denial Of Service And Malicious Code — Kubernetes and Cloud Native Security Associate (KCSA) Exam Prep
- Node Affinity, Pod Affinity And Topology Spread — Kubernetes: Production-Grade Container Orchestration
- Taints, Tolerations And Disruption Budgets — Kubernetes: Production-Grade Container Orchestration
- Troubleshooting: Pending Pod Triage — Kubernetes: Production-Grade Container Orchestration