CertGrid CertGrid
Hands-on Lab·Certified Kubernetes Administrator

Troubleshooting a Namespace Stuck Terminating

A namespace held open by one object inside it. This reads the conditions, shows why they are not enough, finds the object, and is explicit about what the popular one-liner actually abandons.

Troubleshooting Guide 83 of 103 Advanced

Written against the versions above. The finalizer here is a made-up string with no controller. On a real cluster this is nearly always a custom resource whose operator has been uninstalled.

Four nodes, though the whole page is one namespace and one Pod.
Server NameIP AddressOSRolesCPURAMHDD
CKA1001192.168.0.175Ubuntu 26.04 LTSControl Plane Node2 Core4 GB50 GB
CKA1001-NODE01192.168.0.176Ubuntu 26.04 LTSWorker Node2 Core4 GB50 GB
CKA1001-NODE02192.168.0.177Ubuntu 26.04 LTSWorker Node2 Core4 GB50 GB
CKA1001-NODE03192.168.0.178Ubuntu 26.04 LTSWorker Node2 Core4 GB50 GB

Before you start

  1. A namespace that will not go away

  2. The conditions, and why they are not enough

  3. Find the object itself

  4. Clear it the right way

  5. The dangerous shortcut, and why it is dangerous

Official sources