Clúster Kubernetes con Raspberry Pi 4: Guía paso a paso

Transformar un conjunto de modestas Raspberry Pi en un potente clúster de Kubernetes puede parecer una tarea de ciencia ficción, pero es más accesible de lo que imaginas. Esta guía te llevará de la mano para que construyas tu propio laboratorio de orquestación de contenedores en casa. Ideal para aprender, experimentar y desplegar aplicaciones de forma económica y con un consumo energético mínimo. ¡Vamos a empezar!

¿Por Qué Montar un Clúster de Kubernetes en Raspberry Pi?

Crear un clúster con Raspberry Pi no solo es un proyecto fascinante, sino que también ofrece ventajas prácticas muy claras. Si aún dudas, aquí tienes tres razones de peso:

• Aprendizaje Práctico y Real: No hay mejor manera de entender los conceptos de Kubernetes (pods, servicios, despliegues) que administrando un clúster físico. Podrás experimentar con la alta disponibilidad y la tolerancia a fallos de una forma tangible.
• Bajo Coste y Consumo Energético: Un clúster de Raspberry Pi 4 es significativamente más barato que alquilar servidores en la nube a largo plazo para pruebas y proyectos personales. Además, su consumo eléctrico es ridículamente bajo.
• Autonomía y Control Total: Tendrás tu propia nube privada en casa. Despliega servicios, bases de datos o aplicaciones web sin depender de terceros, manteniendo tus datos bajo tu control.

Componentes Necesarios: Hardware y Software

Antes de sumergirnos en la configuración, asegúrate de tener todo lo necesario a mano.

Hardware Recomendado

• Raspberry Pi 4: Al menos 2 unidades (idealmente 3 o más). Recomendamos modelos con 4GB u 8GB de RAM para un mejor rendimiento. Una será el nodo maestro y las demás, los nodos trabajadores.
• Tarjetas MicroSD: Una para cada Raspberry Pi, de al menos 32 GB y de alta velocidad (Clase 10 / A1).
• Fuente de Alimentación: Un cargador USB-C de calidad para cada Pi o una estación de carga multi-puerto potente.
• Carcasa y Refrigeración: Un clúster case con ventiladores es crucial para mantener las temperaturas bajo control.
• Cableado de Red y Switch: Cables Ethernet para cada dispositivo y un switch de red para conectarlos todos.

Software a Utilizar

• Raspberry Pi Imager: La herramienta oficial para flashear el sistema operativo en las tarjetas SD.
• Raspberry Pi OS Lite (64-bit): Una versión ligera y sin escritorio, perfecta para un servidor.
• K3s de Rancher: Una distribución de Kubernetes ligera y certificada, optimizada para arquitecturas ARM como la de la Raspberry Pi.

Guía de Montaje: Tu Clúster K3s Paso a Paso

Con todos los componentes listos, es hora de poner manos a la obra. Seguiremos un proceso lógico para asegurar que todo funcione a la primera.

Paso 1: Preparación de las Tarjetas SD y Configuración Inicial

El primer paso es preparar el sistema operativo para cada una de tus Raspberry Pi. Usando Raspberry Pi Imager, flashea la imagen de Raspberry Pi OS Lite (64-bit) en cada tarjeta microSD.

Antes de expulsar la tarjeta, activa el acceso SSH. Para ello, crea un archivo vacío llamado ssh (sin extensión) en la partición de arranque (boot) de la tarjeta. Esto te permitirá conectarte de forma remota sin necesidad de un monitor o teclado.

Es muy recomendable asignar IPs estáticas a cada Raspberry Pi desde tu router. Esto facilitará la comunicación entre los nodos. Anota qué IP corresponde a cada nodo (ej: 192.168.1.100 para el maestro, 192.168.1.101 para el trabajador 1, etc.).

Paso 2: Instalación del Nodo Maestro (Master Node)

Elige una de tus Raspberry Pi para que actúe como el nodo maestro (o control-plane). Este nodo será el cerebro del clúster. Conéctate a él vía SSH y ejecuta el siguiente comando para instalar K3s:

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

Este script descarga e instala K3s. El flag --write-kubeconfig-mode 644 hace que el archivo de configuración de kubectl (la herramienta para gestionar el clúster) sea accesible para el usuario actual.

Paso 3: Obtener el Token para Unir Nodos

Para que otros nodos (trabajadores) puedan unirse al clúster, necesitan un “secreto” o token de autenticación. Aún en el nodo maestro, ejecuta este comando para obtenerlo:

sudo cat /var/lib/rancher/k3s/server/node-token

Copia y guarda este token. Lo necesitarás en el siguiente paso. ¡Trátalo como una contraseña!

Paso 4: Añadir los Nodos Trabajadores (Worker Nodes)

Ahora, conéctate por SSH a cada una de las otras Raspberry Pi que serán tus nodos trabajadores. En cada una de ellas, ejecuta el siguiente comando, reemplazando <IP_DEL_MAESTRO> y <TOKEN_DEL_MAESTRO> con los valores correctos:

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

Este comando instala el agente de K3s y lo conecta automáticamente al nodo maestro que especificaste.

Paso 5: Verificación y Gestión del Clúster

¡Felicidades! Tu clúster debería estar operativo. Para confirmarlo, vuelve a la sesión SSH del nodo maestro y ejecuta:

kubectl get nodes

Si todo ha ido bien, deberías ver una lista de todos tus nodos (el maestro y los trabajadores) con el estado “Ready”. ¡Ya tienes un clúster de Kubernetes funcional!

Desplegando tu Primera Aplicación: ¡Hola, Mundo!

Para comprobar que todo funciona, despleguemos un servidor web Nginx. Crea un archivo llamado nginx-deployment.yaml en tu nodo maestro con el siguiente contenido:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx
        ports:
        - containerPort: 80

Aplica esta configuración con el comando:

kubectl apply -f nginx-deployment.yaml

Kubernetes ahora descargará la imagen de Nginx y se asegurará de que siempre haya 3 réplicas (pods) ejecutándose en tu clúster. Has desplegado tu primera aplicación distribuida.

Conclusión: Tu Laboratorio Doméstico está Listo

Has construido con éxito un clúster Kubernetes con Raspberry Pi 4. Este pequeño pero potente sistema es la plataforma perfecta para profundizar en el mundo de los contenedores, DevOps y la arquitectura de microservicios. A partir de aquí, las posibilidades son enormes: puedes explorar soluciones de almacenamiento persistente como Longhorn, configurar un Ingress Controller como Traefik para exponer tus servicios, o automatizar despliegues con GitOps. Tu viaje en la orquestación de contenedores no ha hecho más que empezar.