pi-cluster
Clúster Kubernetes híbrido x86/ARM para homelab automatizado con K3S, Ansible y FluxCD. Incluye observabilidad completa (Prometheus, Loki), almacenamiento distribuido (Longhorn) y gestión de secretos (Vault). Ideal para aprender IaC y GitOps en entornos educativos o domésticos con hardware bajo cost
Ficha actualizada 26 sept 2026, 23:40 · upstream 24 sept 2026, 23:47 · release v1.12.0
Qué es pi-cluster
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Pi-cluster es un proyecto educativo diseñado para construir clústeres Kubernetes híbridos x86/ARM en entornos domésticos, utilizando Raspberry Pi y mini PCs reacondicionados. La automatización del despliegue se realiza mediante Ansible para la configuración del sistema operativo y OpenTofu/Terraform para la infraestructura externa, todo gestionado bajo metodologías GitOps con FluxCD.
El proyecto implementa una distribución ligera de Kubernetes basada en K3S y containerd, integrando servicios nativos esenciales como almacenamiento distribuido (Longhorn), gestión de objetos S3 (RustFS) y bases de datos compatibles (Valkey, MongoDB). Además, proporciona una plataforma de observabilidad robusta que combina métricas con Prometheus, logs con Loki/Elasticsearch y trazabilidad con Tempo.
Las limitaciones principales incluyen su complejidad técnica elevada, orientado a usuarios avanzados familiarizados con Kubernetes y herramientas de infraestructura como Ansible o Helm. No está diseñado para entornos de producción crítica empresarial sin supervisión experta, requiriendo conocimientos profundos en gestión de clústeres híbridos y configuración de red avanzada.
- Construcción de clústeres híbridos x86/ARM para aprendizaje práctico de Kubernetes
- Implementación de plataformas de observabilidad completa (monitorización, logs, trazas)
- Despliegue automatizado de bases de datos distribuidas y almacenamiento persistente
- Gestión de identidad y acceso con Keycloak e integración de secretos con Vault
- Automatización de infraestructura mediante IaC y GitOps para entornos educativos
- Automatización completa del ciclo de vida del clúster usando Ansible, OpenTofu y FluxCD
- Soporte nativo para arquitectura híbrida x86/ARM con K3S y containerd
- Stack completo de observabilidad integrado (Prometheus, Loki, Tempo, Grafana)
- Gestión avanzada de almacenamiento distribuido y objetos mediante Longhorn y RustFS
- Seguridad integrada con Cert-manager, Vault y Keycloak para IAM y secretos
- Complejidad alta requiere conocimientos avanzados en Kubernetes y herramientas de IaC
- No utiliza Docker ni Compose, requiriendo gestión directa de K3S y Helm/Kustomize
- Orientado a entornos educativos/homelab, no apto para producción crítica sin supervisión
- Dependencia de hardware específico (Raspberry Pi + mini PCs) para el despliegue híbrido
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere hardware híbrido x86/ARM y conocimientos avanzados en Kubernetes. Se recomienda configurar red segura antes del despliegue, asegurar copias de seguridad con Velero y Restic, y mantener actualizadas las herramientas de IaC (Ansible/OpenTofu). No apto para entornos críticos sin experiencia previa en gestión de clústeres.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.