kubernetes/script_limpieza.md

Manual: Reinicio completo (modo nuclear) de un nodo Kubernetes

Este script permite realizar un reseteo completo de un nodo Kubernetes, eliminando su configuración, interfaces de red sobrantes, y preparándolo para un kubeadm join limpio. Es útil cuando el nodo ha quedado en estado inconsistente o se desea reutilizar desde cero.

---

Contenido del script reset_nodo.sh

#!/bin/bash

echo "==============================" echo " K8s HARD RESET (modo nuclear)" echo "=============================="

Obtener nombre del nodo

NODENAME=$(hostname) echo "Nodo detectado: $NODENAME"

Eliminar nodo del clúster

echo "1. Eliminando el nodo del clúster..." kubectl delete node "$NODENAME" || echo "⚠️ No se pudo eliminar el nodo. ¿Está desconectado del clúster?"

Guardar kubeconfig local si no existe

if [ ! -f "$HOME/.kube/config" ]; then echo "2. Guardando credenciales kubeconfig en ~/.kube/config..." mkdir -p "$HOME/.kube" sudo cp /etc/kubernetes/admin.conf "$HOME/.kube/config" 2>/dev/null || echo "⚠️ No se pudo copiar kubeconfig (¿es un nodo worker?)" sudo chown "$(id -u):$(id -g)" "$HOME/.kube/config" fi

Reset kubeadm

echo "3. Ejecutando kubeadm reset..." sudo kubeadm reset -f

Parar servicios

echo "4. Parando servicios kubelet y containerd..." sudo systemctl stop kubelet sudo systemctl stop containerd

Limpiar configuraciones

echo "5. Borrando configuraciones CNI, kubelet, pods y logs..." sudo rm -rf /etc/cni/net.d/* sudo rm -rf /var/lib/cni/ sudo rm -rf /run/flannel/* sudo rm -rf /run/docker/netns/* sudo rm -rf /var/lib/kubelet/* sudo rm -rf /etc/kubernetes/* sudo rm -rf /var/log/pods/* sudo rm -rf /var/log/containers/*

Borrar interfaces sobrantes

echo "6. Eliminando interfaces virtuales (ignora errores si no existen)..." sudo ip link delete flannel.1 2>/dev/null sudo ip link delete cni0 2>/dev/null sudo ip link delete docker0 2>/dev/null

Reiniciar servicios

echo "7. Reiniciando containerd y kubelet..." sudo systemctl restart containerd sudo systemctl restart kubelet

Preguntar si desea reiniciar

echo "======================================" read -p "¿Deseas reiniciar el nodo ahora? [s/N]: " confirm if [[ "confirm" =~ ^[Ss] ]]; then echo "Reiniciando..." sudo reboot else echo "No se reiniciará. Ejecútalo manualmente cuando estés listo." echo " sudo reboot" fi echo "======================================" echo " RESET COMPLETADO " echo "======================================"

---

Cómo usar el script

1. Guardar el archivo:

Guarda el contenido anterior en un archivo llamado reset_nodo.sh

nano reset_nodo.sh

2. Dar permisos de ejecución:

chmod +x reset_nodo.sh

3. Ejecutar el script:

./reset_nodo.sh

Asegúrate de tener permisos sudo, ya que muchos comandos requieren privilegios de root.

4. Reinicio (opcional):

El script preguntará al final si deseas reiniciar el nodo. Se recomienda decir que sí (s) para garantizar una limpieza total.

---

Advertencia

Este script elimina todos los datos y configuraciones de Kubernetes y CNI del nodo. Asegúrate de:

Eliminar el nodo primero del clúster (kubectl delete node) o dejar que el script lo haga.

Tener backup de cualquier dato o log importante.

Ideal para casos de limpieza completa o reinstalación. No recomendado si solo necesitas reintegrar un nodo sano. En ese caso, usa kubeadm reset y kubeadm join directamente.