flux-homelab
Repositorio de homelab con infraestructura Kubernetes basada en Talos Linux, FluxCD y herramientas de IaC, diseñado como entorno de aprendizaje práctico.
Ficha actualizada 22 sept 2026, 22:22 · upstream 22 sept 2026, 22:19 · release sin release detectada
Qué es flux-homelab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto es un entorno de desarrollo personal (homelab) que sirve como plataforma práctica para aprender e implementar prácticas de Infraestructura como Código (IaC). Utiliza Kubernetes como núcleo del sistema operativo virtualizado, con Talos Linux como distribución base en todos los nodos. La infraestructura se gestiona mediante FluxCD, un tool GitOps que permite definir y aplicar el estado del cluster a través de repositorios Git.
El proyecto está construido sobre una arquitectura modular donde cada nodo (master o worker) corre Talos Linux con la imagen oficial de Kubernetes. Los nodos master tienen 4 vCPU y 4GB de RAM, mientras los nodos workers comparten recursos. Se implementa un sistema de almacenamiento distribuido basado en Longhorn para persistencia de datos.
El entorno incluye un proxy de DNS externo (CoreDNS), un router de red Cloudflare configurado a través del gateway Envoy Gateway, y un sistema de autenticación centralizado con Authentik que proporciona identidad federada entre servicios. El proyecto también integra herramientas de seguridad como SOPS para la gestión segura de secretos.
El objetivo principal es proporcionar un entorno educativo donde los desarrolladores pueden experimentar con conceptos avanzados de Kubernetes, incluyendo escalabilidad horizontal, control de versiones de configuración, observabilidad y automatización mediante GitOps.
- Aprender a implementar infraestructura completa desde cero usando Helm charts y FluxCD
- Experimentar con un entorno de desarrollo personal (homelab) que simula una producción real
- Practicar la gestión de secretos en Kubernetes mediante SOPS y External Secrets
- Implementar autenticación federada entre servicios utilizando Authentik como IdP centralizado
- Estudiar el funcionamiento del gateway Envoy Gateway para proxy de tráfico en Kubernetes
- Aprender a configurar un sistema de almacenamiento distribuido con Longhorn sobre Talos Linux
- Utiliza Talos Linux como base, lo que permite una imagen única y consistente sin dependencias externas complejas
- Implementa GitOps mediante FluxCD, permitiendo despliegues declarativos y versionados de toda la infraestructura
- Incluye un sistema de autenticación centralizado con Authentik, facilitando el control de acceso entre servicios
- Utiliza CoreDNS como DNS cluster, eliminando la necesidad de resolver nombres manualmente en cada nodo
- Implementa almacenamiento distribuido con Longhorn sobre Talos Linux, ofreciendo escalabilidad y redundancia
- Incluye un proxy de tráfico Envoy Gateway que reemplaza a ingress-nginx, permitiendo control granular del tráfico
- No incluye herramientas de observabilidad nativas como Prometheus o Grafana en el cluster (solo se mencionan como dependencias externas)
- El almacenamiento Longhorn requiere configuración manual adicional y no es completamente automático
- La implementación de Talos Linux con Kubernetes puede ser compleja para usuarios que no tienen experiencia previa
- No incluye herramientas de despliegue nativas como Ansible ni Terraform, lo que limita la automatización a nivel de infraestructura
- El proyecto depende de dependencias externas (CoreDNS, Authentik, Longhorn) que deben mantenerse actualizadas manualmente
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.
Para desplegar este homelab, se recomienda instalar Proxmox como hypervisor y ejecutar Talos Linux en los nodos master. Se debe configurar un cluster de Kubernetes con 3 master nodes (4 vCPU, 4GB RAM) y worker nodes con recursos reducidos. Se debe implementar un sistema de secretos usando SOPS y External Secrets para gestionar credenciales sin commitar a Git. El DNS se configura mediante CoreDNS en cada nodo. Para la autenticación, se instala Authentik como IdP centralizado y se configuran los servicios para usarlo como source of truth. La persistencia de datos se gestiona con Longhorn sobre un volume de Talos Linux. Se recomienda ejecutar el proyecto desde un entorno local (Docker Desktop) antes del despliegue en producción.
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.