Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

otaru

Laboratorio de hogar bare-metal para Kubernetes basado en Raspberry Pi 5 y k3s. Incluye malla de servicio Istio ambient, gestión de red avanzada con Flannel WireGuard y optimización de recursos mediante bin-packing para cargas de trabajo heterogéneas en un entorno técnico complejo.

Ficha actualizada 22 sept 2026, 15:34 · upstream 22 sept 2026, 14:26 · release tailscale-operator-0.1.0

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es otaru

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Otaru es un repositorio que define una infraestructura bare-metal para Kubernetes utilizando k3s como motor principal, diseñado específicamente para entornos de laboratorio doméstico con hardware limitado pero potente como las Raspberry Pi 5. La arquitectura se centra en la eficiencia y la seguridad, implementando una red segmentada mediante VLANs dedicadas para nodos del clúster y servicios VIPs, asegurando el aislamiento lógico entre dispositivos IoT, invitados y clientes confiables.

El despliegue incluye componentes avanzados como Istio ambient mesh para observabilidad de malla de servicio, Envoy Gateway para gestión de ingress y MetalLB para IPs virtuales. Se prioriza la consolidación de recursos mediante bin-packing del kube-scheduler para maximizar la capacidad de memoria disponible en nodos específicos, permitiendo ejecutar cargas de trabajo grandes en hardware con restricciones físicas estrictas.

Además, el proyecto integra servidores MCP (Model Context Protocol) para orquestación y automatización, protegidos por autenticación JWT a través de Envoy Gateway. La infraestructura combina almacenamiento persistente de alta capacidad con sistemas de archivos NVMe y SSDs SATA, gestionados en nodos control y worker distribuidos estratégicamente dentro del rack.

CASOS DE USO
  • Laboratorio técnico bare-metal para pruebas de Kubernetes sin virtualización pesada
  • Plataforma de automatización doméstica (Home Assistant) con malla de servicio Istio
  • Entorno de desarrollo y análisis de datos con servidores MCP para Kubernetes y UniFi
  • Red de detección de cambios web y analítica auto-alojada (Umami, Blocky)
  • Infraestructura de red segura con segmentación VLAN y encriptación WireGuard nativa
PUNTOS DESTACADOS
  • Uso exclusivo de Raspberry Pi 5 para nodos control plane y worker principales
  • Implementación de Istio ambient mesh para observabilidad completa de la malla de servicio
  • Optimización de recursos mediante bin-packing del kube-scheduler para consolidar memoria
  • Autenticación JWT-gated para servidores MCP en el borde con Envoy Gateway
  • Red segmentada con VLAN dedicada (192.168.10.0/24) y Flannel WireGuard nativo
PRECAUCIONES
  • Complejidad alta de configuración inicial no apta para usuarios novatos en Kubernetes
  • Dependencia de hardware específico (Raspberry Pi 5) con requisitos de almacenamiento NVMe/SSD
  • Uso de NUC como nodo worker temporal indica limitaciones de rendimiento del hardware Raspberry Pi para cargas pesadas
  • Gestión manual de certificados y configuración de red avanzada requiere conocimientos técnicos profundos
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA4 GBRAM estimada
DISCO20 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Requiere bare-metal con al menos 4 núcleos CPU y 4GB RAM por nodo. Configurar VLAN dedicada 192.168.10.0/24 para el clúster. Instalar k3s con Flannel wireguard-native. Activar bin-packing en kube-scheduler y Descheduler. Configurar Envoy Gateway para MCP servers con JWT.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.js
SERVICIOS
PostgreSQLS3/MinIO
BASES DE DATOS
PostgreSQL
PUERTOS
No detectados
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.