Clúster Kubernetes en Raspberry Pi 4 para Domótica

Transformar tu hogar en un ecosistema inteligente, eficiente y robusto es más accesible que nunca. Si eres un entusiasta de la tecnología y la domótica, probablemente ya conozcas el potencial de la Raspberry Pi. Pero, ¿y si te dijera que puedes llevar tu sistema al siguiente nivel de profesionalismo y resiliencia? En esta guía completa, te enseñaremos a crear un clúster Kubernetes en Raspberry Pi 4, sentando las bases para un sistema de domótica verdaderamente escalable y a prueba de fallos.

Olvídate de las configuraciones frágiles que dependen de una única placa. Con un clúster, distribuimos la carga y aseguramos que servicios críticos como Home Assistant, Node-RED o MQTT sigan funcionando incluso si uno de los nodos falla. ¡Prepárate para construir el cerebro definitivo para tu hogar inteligente!

¿Por qué un Clúster Kubernetes en Raspberry Pi para tu Hogar Inteligente?

Puede sonar complejo, pero implementar Kubernetes (K8s) en un entorno doméstico con Raspberry Pi ofrece ventajas abrumadoras que justifican el esfuerzo inicial. No se trata solo de un proyecto técnico fascinante, sino de una inversión en la estabilidad y el futuro de tu domótica.

• Alta Disponibilidad: Si una Raspberry Pi (nodo) falla, Kubernetes automáticamente reprograma tus aplicaciones (pods) en los nodos que siguen activos. Tu sistema de luces, sensores y automatizaciones seguirá funcionando sin interrupciones.
• Escalabilidad Sencilla: ¿Necesitas más potencia para procesar datos de nuevas cámaras o sensores? Simplemente añade otra Raspberry Pi al clúster. Kubernetes se encargará de distribuir la carga de trabajo de manera eficiente.
• Gestión Centralizada: Administra todas tus aplicaciones de domótica (Home Assistant, Zigbee2MQTT, Plex, etc.) como contenedores desde un único punto. Olvídate de configurar cada servicio en una máquina diferente.
• Eficiencia de Recursos: Kubernetes optimiza el uso de la CPU y la RAM de tus Raspberry Pi, asegurando que cada placa se aproveche al máximo. Esto es especialmente útil para dispositivos con recursos limitados.
• Aislamiento de Aplicaciones: Cada servicio se ejecuta en su propio contenedor, lo que mejora la seguridad y evita que un fallo en una aplicación afecte a las demás.

Requisitos Previos: Lo que Necesitas para Empezar

Antes de sumergirnos en la configuración, asegúrate de tener a mano el siguiente material. Recomendamos un mínimo de dos Raspberry Pi para tener un nodo maestro y un nodo trabajador.

Hardware Necesario

• Raspberry Pi 4: Al menos 2 unidades (idealmente 3). El modelo con 4GB u 8GB de RAM es preferible para el nodo maestro.
• Tarjetas microSD: Una por cada Raspberry Pi, de al menos 32GB y de alta velocidad (Clase 10 / A1).
• Fuentes de Alimentación: Una fuente de alimentación USB-C oficial o de calidad para cada placa.
• Cables de Red Ethernet: Uno por cada Raspberry Pi.
• Switch de Red: Para conectar todas las placas a tu red local.

Software y Herramientas

• Raspberry Pi OS Lite (64-bit): La versión sin entorno de escritorio es ideal para ahorrar recursos.
• Raspberry Pi Imager o Balena Etcher: Para flashear el sistema operativo en las tarjetas microSD.
• Cliente SSH: Como PuTTY (Windows) o el terminal integrado (macOS/Linux) para conectarte a las placas.

Guía Paso a Paso para Montar tu Clúster K8s

Para simplificar el proceso, utilizaremos K3s, una distribución de Kubernetes ligera y certificada, desarrollada por Rancher, que es perfecta para dispositivos con recursos limitados como la Raspberry Pi.

Paso 1: Preparación de las Raspberry Pi

Este primer paso debe realizarse en todas las tarjetas microSD.

1. Flashea el Sistema Operativo: Usa Raspberry Pi Imager para instalar Raspberry Pi OS Lite (64-bit). En las opciones avanzadas (Ctrl+Shift+X), activa el SSH, crea un usuario y configura tu red WiFi si no usarás Ethernet.
2. Configura IPs Estáticas: Es crucial que cada nodo tenga una IP fija. Puedes hacerlo desde la configuración de tu router o editando el archivo /etc/dhcpcd.conf en cada Pi.
3. Actualiza el Sistema: Conéctate por SSH a cada Pi y ejecuta los siguientes comandos:

   sudo apt update && sudo apt upgrade -y

4. Habilita los cgroups: Para que los contenedores funcionen correctamente, edita el archivo /boot/cmdline.txt y añade al final de la línea (con un espacio de por medio) lo siguiente: cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1. Después, reinicia con sudo reboot.

Paso 2: Instalación de K3s en el Nodo Maestro (Master)

Elige una de tus Raspberry Pi para que actúe como el cerebro del clúster (el nodo maestro). Conéctate a ella por SSH y ejecuta este simple comando:

curl -sfL https://get.k3s.io | sh -s - --write-kubeconfig-mode 644

Este script descargará e instalará K3s. Una vez finalizado, verifica que el servicio está corriendo con sudo systemctl status k3s.

Ahora, necesitas obtener dos datos clave para unir los otros nodos:

• La IP del maestro: Usa hostname -I para verla.
• El token de unión: Ejecuta sudo cat /var/lib/rancher/k3s/server/node-token para obtenerlo. Guárdalo bien.

Paso 3: Uniendo los Nodos Trabajadores (Workers)

Ahora, conéctate por SSH a cada una de las otras Raspberry Pi (los nodos trabajadores) y ejecuta el siguiente comando, reemplazando <IP_DEL_MAESTRO> y <TOKEN_DE_UNION> con los datos que obtuviste en el paso anterior:

curl -sfL https://get.k3s.io | K3S_URL=https://<IP_DEL_MAESTRO>:6443 K3S_TOKEN=<TOKEN_DE_UNION> sh -

Este proceso unirá el nodo trabajador al clúster. Repite la operación en todas las Pi que quieras añadir.

Paso 4: Verificación del Clúster

Vuelve a la sesión SSH del nodo maestro. Para confirmar que todos los nodos se han unido correctamente, ejecuta:

kubectl get nodes -o wide

Deberías ver una lista de todos tus nodos con el estado “Ready”. ¡Felicidades! Acabas de crear tu propio clúster Kubernetes en Raspberry Pi.

Desplegando tu Primera Aplicación: Home Assistant

Un clúster sin aplicaciones no sirve de mucho. Vamos a desplegar Home Assistant como ejemplo. Crea un archivo llamado home-assistant.yaml en tu nodo maestro y pega el siguiente contenido:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: home-assistant
spec:
  replicas: 1
  selector:
    matchLabels:
      app: home-assistant
  template:
    metadata:
      labels:
        app: home-assistant
    spec:
      containers:
      - name: home-assistant
        image: homeassistant/home-assistant:stable
        ports:
        - containerPort: 8123
---
apiVersion: v1
kind: Service
metadata:
  name: home-assistant-svc
spec:
  selector:
    app: home-assistant
  ports:
    - protocol: TCP
      port: 8123
      targetPort: 8123
  type: LoadBalancer

Ahora, aplica este manifiesto con el comando:

kubectl apply -f home-assistant.yaml

Kubernetes descargará la imagen de Home Assistant y la ejecutará en uno de los nodos trabajadores. Para acceder, busca la IP externa que le asignó el balanceador con kubectl get services y navega a http://<IP_EXTERNA>:8123. ¡Ya tienes tu domótica corriendo en un entorno profesional!

Conclusión: El Futuro de tu Domótica es Ahora

Montar un clúster Kubernetes en Raspberry Pi 4 puede parecer una tarea intimidante, pero como has visto, herramientas como K3s han simplificado enormemente el proceso. Los beneficios en resiliencia, escalabilidad y gestión son innegables y transformarán tu sistema de domótica de un hobby a una infraestructura robusta y confiable.

Este es solo el punto de partida. Desde aquí, puedes explorar el despliegue de bases de datos, sistemas de monitorización como Prometheus y Grafana, o cualquier otra aplicación que enriquezca tu hogar inteligente. Has dado el paso más importante para construir una base sólida sobre la que tu ecosistema domótico podrá crecer sin límites.