Back to all scenarios
Scenario #315
Storage
Kubernetes v1.25, Bare Metal

CSI Driver DaemonSet Deployment Missing Tolerations for Taints

CSI Node plugin DaemonSet didn’t deploy on all nodes due to missing taint tolerations.

Find this helpful?
What Happened

Storage nodes were tainted (node-role.kubernetes.io/storage:NoSchedule), and the CSI DaemonSet didn’t tolerate it, so pods failed to mount volumes.

Diagnosis Steps
  • 1CSI node pods not scheduled on certain nodes.
  • 2Checked node taints vs DaemonSet tolerations.
  • 3Pods stuck in Pending.
Root Cause

Taint/toleration mismatch in CSI node plugin manifest.

Fix/Workaround
• Added required tolerations to DaemonSet.
Lessons Learned

Storage plugins must tolerate relevant node taints to function correctly.

How to Avoid
  • 1Review node taints and CSI tolerations during setup.
  • 2Use node affinity and tolerations for critical system components.