kubernetes-homelab
Repositorio GitOps completo para un clúster K3s en homelab con dos nodos Beelink N100, gestionando media, monitorización y automatización doméstica mediante ArgoCD, Cilium y Longhorn.
Ficha actualizada 26 sept 2026, 10:18 · upstream 26 sept 2026, 9:56 · release sin release detectada
Qué es kubernetes-homelab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio define el estado declarativo de un clúster Kubernetes K3s desplegado en una infraestructura de homelab compuesta por dos mini PCs Beelink N100. La arquitectura está diseñada para ser resiliente, escalable y mantenible mediante prácticas cloud-native, integrando GitOps como mecanismo principal de gestión del ciclo de vida.
- Despliegue de un clúster Kubernetes auto-gerenciado en hardware doméstico con alta disponibilidad básica mediante replicación de datos.
- Gestión declarativa de aplicaciones de medios (Jellyfin, Radarr) y automatización del hogar (Home Assistant) usando GitOps con ArgoCD.
- Implementación de una red interna segura con Cilium Gateway API y Tailscale para acceso remoto enmascarado.
- Monitorización completa del clúster y aplicaciones mediante Prometheus, Grafana y Uptime Kuma integrados en el mismo stack.
- Arquitectura GitOps pura: todo el estado del clúster está versionado en Git y reconciliado automáticamente por ArgoCD.
- Resiliencia de datos con Longhorn para almacenamiento bloque distribuido y Garage para almacenamiento S3 compatible.
- Automatización de actualizaciones mediante Renovate para dependencias de Helm y ArgoCD Image Updater para nuevas tags de imágenes.
- Seguridad integrada con Sealed Secrets para encriptar credenciales en Git y cert-manager para certificados Let's Encrypt automáticos.
- Requiere hardware específico (Beelink N100 o similar) con al menos 4 núcleos y 8 GB de RAM por nodo para un funcionamiento estable.
- Dependencia de Tailscale para acceso remoto, lo que implica una conexión a internet activa y configuración de firewall en el router.
- La gestión de secretos se realiza mediante Sealed Secrets, requiriendo la instalación del controller antes de poder desplegar aplicaciones.
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.
Despliegue recomendado en dos nodos con al menos 16 GB de RAM y 500 GB de almacenamiento NVMe. Configurar MetalLB con un pool de IPs L2 (ej. 10.10.1.230-250) para servicios LoadBalancer. Instalar Cilium como CNI y Gateway API antes de las aplicaciones. Asegurar la red interna y configurar Tailscale para acceso remoto seguro.
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.