Aprende a Preparar nodos Ubuntu con containerd para Kubernetes usando kubeadm

Paso 1: Preparar el servidor o entorno

Antes de ejecutar cambios, confirma que estás en el servidor correcto y que cuentas con una ventana de mantenimiento si el servicio ya recibe tráfico.

sudo swapoff -a

Verifica la salida antes de continuar. Si el comando impacta red, credenciales, firewall, base de datos o runtime de contenedores, toma una copia de seguridad y conserva una ruta de rollback.

Paso 2: Instalar o activar componentes necesarios

Activa los módulos necesarios para que el nodo pueda trabajar correctamente con las capas de red requeridas por Kubernetes.

sudo modprobe overlay br_netfilter

Verifica la salida antes de continuar. Si el comando modifica una capa sensible del sistema, documenta el cambio y conserva una forma clara de volver atrás.

Paso 3: Configurar parámetros de red

Define los parámetros base de red que necesita Kubernetes para manejar tráfico entre contenedores, pods y nodos.

net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1

Después de aplicar la configuración, recarga los parámetros del sistema.

sudo sysctl --system

Verifica la salida antes de continuar y revisa cualquier advertencia relacionada con parámetros no encontrados o archivos de configuración mal formateados.

Paso 4: Instalar herramientas de Kubernetes

Instala las herramientas necesarias para inicializar y operar el nodo dentro del clúster.

sudo apt install -y kubelet kubeadm kubectl

Confirma que la instalación finalice sin errores antes de avanzar. Si el servidor usa repositorios restringidos, proxy o políticas internas de paquetes, valida que las versiones instaladas sean las esperadas.

Paso 5: Inicializar el clúster y dejar base de mantenimiento

Con la base lista, puedes iniciar el clúster usando kubeadm.

sudo kubeadm init --pod-network-cidr=10.244.0.0/16

Verifica la salida antes de continuar. Este paso modifica el estado del nodo y debe ejecutarse con especial cuidado si el servidor forma parte de un entorno compartido o con servicios activos.

Problemas frecuentes

Permisos insuficientes: revisa el usuario, el grupo, el rol IAM o el contexto de Kubernetes antes de repetir comandos con más privilegios.
Puerto ocupado o cerrado: valida con ss -tulpn, reglas de firewall y security groups antes de asumir que la aplicación falló.
Variables de entorno ausentes: confirma .env, secretos del orquestador y que no se impriman credenciales en logs.
Servicio inicia pero no responde: revisa healthchecks, logs, dependencia de base de datos y resolución DNS.
Rollback no definido: conserva versión anterior, snapshot, backup o manifiesto previo antes de aplicar cambios sensibles.

Buenas prácticas para producción

Usa mínimo privilegio para usuarios, roles, contenedores y reglas de red.
Versiona configuraciones sin incluir secretos.
Prueba restauraciones de backup, no solo la creación del archivo.
Activa logs y alertas antes de necesitar diagnosticar un incidente.
Documenta quién puede ejecutar cambios y qué evidencia debe quedar.
Revisa periódicamente dependencias, imágenes y paquetes del sistema.

Advertencias de seguridad

No ejecutes estos pasos contra infraestructura de terceros ni contra producción sin autorización.

Los comandos de seguridad se orientan a defensa, mitigación y auditoría autorizada. Si detectas credenciales expuestas, rota primero y luego investiga el alcance.