Не удаляйте `spec.finalizers` сразу. Сначала сохраните YAML namespace и посмотрите `status.conditions`: там обычно видно, не отвечает ли discovery API, остались ли ресурсы или контроллер не завершил очистку. Принудительное завершение способно оставить объекты, которые потом нельзя получить обычным запросом через уже удалённый namespace.

Kubernetes ставит `deletionTimestamp`, а объект исчезает только после очистки finalizers. Это не таймер и не зависший интерфейс: finalizer означает, что контроллер ещё обязан выполнить действие. Правильное исправление — вернуть контроллеру возможность завершить работу или осознанно убрать конкретный блокатор.

Состояние namespace задаёт первую ветку

НаблюдениеВероятный блокаторСледующая проверка
NamespaceDeletionDiscoveryFailure=TrueНедоступен aggregated API`kubectl get apiservice | grep False`
NamespaceContentRemaining=TrueВ namespace остались объектыПеребор namespaced api-resources
NamespaceFinalizersRemaining=TrueРесурс ждёт свой контроллерFinalizers оставшегося объекта
Conditions пусты, объект не исчезаетПроблема controller-manager/APIСобытия и control-plane logs
Namespace удалён, данные видны в storageРанее выполнен force finalizeИнвентаризация orphaned resources

Сначала зафиксируйте время начала удаления, версию кластера и полный список conditions. Скриншот строки `Terminating` почти бесполезен: он не показывает причину и теряет имена finalizer-ключей.

Проверки идут от API discovery к содержимому

NS=example-stuck
kubectl get namespace "$NS" -o yaml
kubectl get apiservice | grep False

kubectl api-resources --verbs=list --namespaced -o name \
  | xargs -n 1 kubectl get -n "$NS" --ignore-not-found

Переменная `NS` здесь условная: подставьте точное имя после проверки контекста `kubectl config current-context`. Команды читают состояние. Если APIService показывает False, разберите его через `kubectl describe apiservice NAME`; пока discovery неполон, список ресурсов нельзя считать исчерпывающим.

Оставшийся объект чинится у своего контроллера

  • Custom Resource с finalizer оператора: верните operator или проверьте его логи и права.
  • PVC/PV protection: найдите использующий том Pod и завершите корректную цепочку хранения.
  • Webhook мешает delete/update: восстановите endpoint или временно исправьте конфигурацию по процедуре владельца.
  • Job/Pod висит на удалении: изучите ownerReferences, grace period и состояние node, а не удаляйте весь namespace вслепую.
  • Неизвестный finalizer: найдите контроллер-владельца по имени ключа и документации установленного компонента.

Удаление finalizer с дочернего объекта допустимо только когда вы понимаете, какую внешнюю очистку пропустите: облачный load balancer, диск, DNS-запись или запись оператора. Сохраните manifest и причину ручного вмешательства.

Force finalize — аварийный выход, не ремонт

Официальная инструкция GKE ставит принудительное удаление namespace последним шагом после недоступных APIService и оставшихся ресурсов. Перед finalize выгрузите manifests, согласуйте риск orphaned resources и подготовьте проверку облачных ресурсов. Не используйте команду из случайной инструкции, пока не сверили URL, имя namespace и kube-context.

Если аварийный шаг всё же нужен, работайте с сохранённой копией namespace и endpoint `/finalize` по актуальной документации вашего окружения. Автоматизация не должна массово очищать finalizers: ручной случай обязан оставаться наблюдаемым и аудируемым.

После удаления проверяем не только kubectl get ns

Успех означает: namespace отсутствует, связанные cloud volumes/load balancers не остались бесхозными, APIService снова Available, а контроллеры не повторяют ошибки. Создайте временный namespace с тем же типом ресурсов и удалите его штатно — так вы отличите разовый повреждённый объект от продолжающейся поломки оператора.

Материалы для разбора не содержат kubeconfig

Подготовьте YAML namespace, conditions, список False APIService, типы оставшихся ресурсов и имена finalizers. Удалите Secrets и значения аннотаций с токенами. Kubeconfig, client certificate и cloud credentials в диагностический архив не включаются.

Проверенные источники