Skip to content

Insufficient Resources

Error message

                0/3 nodes are available: 3 Insufficient cpu
              

Quick summary

The cluster does not have enough available CPU or memory to schedule the Pod's requested resources.

Why this happens

  • The Pod requests more CPU or memory than any node has available

  • The cluster is at capacity — all nodes are fully allocated

  • Resource requests are set too high for the actual needs

  • Nodes are cordoned or drained, reducing available capacity

Minimal example

✗ Broken code
resources:
  requests:
    cpu: 4    # no single node has 4 CPU free
    memory: 16Gi
✓ Fixed code
resources:
  requests:
    cpu: 1    # reasonable request
    memory: 2Gi

The Pod requests 4 CPUs but no node has that much free. The fix reduces the request to a realistic value.

How to diagnose

  • Check node resources: kubectl describe nodes and look at Allocatable vs Allocated

  • View Pod resource requests: kubectl get pods -o yaml and check resources.requests

  • Check for cordoned nodes: kubectl get nodes

  • Use kubectl top nodes to see current resource usage

How to fix

  • Reduce the Pod's resource requests to match actual needs

  • Add more nodes to the cluster (scale the cluster)

  • Uncordon nodes that were accidentally cordoned

  • Delete or migrate Pods that are over-consuming resources

How to prevent

  • Set realistic resource requests based on actual usage

  • Use cluster autoscaler to add nodes automatically when needed

  • Monitor cluster capacity and alert before it is full

Related Resources

Related Glossary

← Back to language