k8s-homelab
Mono-repo para infraestructura doméstica automatizada con Kubernetes, Talos y GitOps (Flux/Renovate). Gestiona aplicaciones persistentes en Rook/Ceph y NFS externo.
Ficha actualizada 22 sept 2026, 1:50 · upstream 22 sept 2026, 1:50 · release adguard
Qué es k8s-homelab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio es un mono-repo diseñado para gestionar infraestructuras domésticas mediante Infrastructure as Code. Se basa en el concepto de GitOps utilizando Flux como motor de sincronización entre el código fuente (YAML manifests) y el clúster Kubernetes real. La automatización incluye Renovate para la actualización automática de dependencias, go-task para tareas de mantenimiento y scripts de shell para orquestación inicial.
La arquitectura utiliza Talos como sistema operativo ligero para los nodos del clúster, lo que reduce la superficie de ataque y simplifica las actualizaciones. El almacenamiento persistente se gestiona mediante una combinación de Rook/Ceph en discos NVMe locales de los workers (con replicación) y un servidor NFS externo para datos menos críticos o temporales. La gestión de secretos se realiza con external-secrets, integrándose con proveedores externos como 1Password.
El repositorio soporta múltiples clústeres (main y staging), permitiendo probar cambios en un entorno aislado antes de aplicarlos al clúster principal. La configuración de red utiliza VLANs separados para el clúster, servidores externos e IoT, con acceso seguro vía Wireguard y gestión de DNS mediante CoreDNS y external-dns.
- Gestión automatizada de infraestructura doméstica (homelab) con Kubernetes
- Despliegue y actualización de aplicaciones persistentes en clúster Kubernetes
- Sincronización de configuraciones entre repositorio Git y clúster mediante Flux
- Monitoreo centralizado del hardware y consumo de recursos del clúster
- Integración con Talos para nodos seguros y actualizables sin intervención manual
- Automatización completa de dependencias con Renovate y PRs automáticos en GitHub
- Almacenamiento persistente híbrido: Rook/Ceph (rápido/replicado) + NFS externo
- Gestión automática de certificados SSL mediante cert-manager y DNS01
- Complejidad alta (HIGH) no apta para usuarios sin experiencia en Kubernetes/Talos
- Dependencia de hardware compatible con Talos (no soporta Docker/Compose nativo)
- Configuración inicial manual de secretos externos (ej. 1Password) requerida
- Requiere red VLAN separada y acceso Wireguard para conectividad externa segura
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.
Leer README completo antes del despliegue. Preparar hardware compatible con Talos (mínimo 4 núcleos CPU, 4GB RAM). Configurar red con VLANs separados (HOMELAB, STAGING, SERVERS, IoT). Iniciar con clúster staging para pruebas antes de usar main cluster. Configurar external-secrets con credenciales de 1Password. Asegurar acceso Wireguard único en firewall externo.
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.