kubernetes lifecycle_error ai_generated partial

Pod stuck in Terminating state

ID: kubernetes/pod-terminating-stuck

Also available as: JSON · Markdown
82%Fix Rate
85%Confidence
50Evidence
2023-01-01First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
8 active — — —

Root Cause

Pod won't terminate. Finalizers, stuck containers, or graceful shutdown timeout.

generic

Workarounds

  1. 90% success Force delete: kubectl delete pod <name> --grace-period=0 --force 
    kubectl delete pod <name> --grace-period=0 --force

    Sources: https://kubernetes.io/docs/tasks/run-application/force-delete-stateful-set-pod/

  2. 88% success Check for finalizers preventing deletion: kubectl get pod <name> -o json | jq '.metadata.finalizers' 
    kubectl get pod <name> -o json | jq '.metadata.finalizers'

    Sources: https://kubernetes.io/docs/concepts/overview/working-with-objects/finalizers/

  3. 82% success Check if the container's SIGTERM handler is stuck — may need code fix 
    Check if the container's SIGTERM handler is stuck — may need code fix

    Sources: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-termination

Dead Ends

Common approaches that don't work:

  1. Set terminationGracePeriodSeconds to 0 65% fail

    Skips graceful shutdown — data loss risk

Error Chain

Frequently confused with: