erasmus.works
Repositorio personal de Kubernetes para un homelab con Talos Linux, Argo CD y infraestructura autoadministrada.
Ficha actualizada 23 sept 2026, 15:07 · upstream 23 sept 2026, 15:03 · release sin release detectada
Qué es erasmus.works
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio es la fuente de verdad para mi cluster de Kubernetes en un homelab. Me esfuerzo por mantenerlo simple, reproducible y confiable siguiendo prácticas de IaC (Infraestructura como Código) y GitOps con herramientas como Talos Linux, Kubernetes, Argo CD y Renovate.
El proyecto se centra en una arquitectura donde el control plane corre en Talos Linux sobre un cluster de dos nodos. La infraestructura se define mediante archivos YAML declarativos que se aplican a través de Argo CD, mientras que la gestión de dependencias de terceros se realiza con herramientas como External Secrets Operator y Renovate.
La arquitectura incluye servicios autoadministrados como Envoy Gateway para el control de tráfico en-cluster, MetalLB para provisionamiento de IPs de servicio, Cloudflare Tunnel para acceso externo sin abrir puertos, y Blocky para DNS local. Los datos persisten mediante Longhorn sobre volumes de almacenamiento local, mientras que los logs se almacenan en VictoriaLogs.
La infraestructura también incluye un sistema de backups con VolSync (basado en Restic) y una capa de almacenamiento S3 compatible a través de Garage, junto con herramientas de observabilidad como Prometheus, Grafana, Alertmanager y Fluent Bit para la recolección de logs.
- Monitoreo continuo del estado del cluster mediante métricas en tiempo real (CPU, memoria, nodos) integradas con Prometheus y Grafana
- Gestión declarativa de aplicaciones a través de Argo CD que sincroniza el repositorio Git con los manifests del cluster
- Provisionamiento automático de servicios externos como DNS (Cloudflare), almacenamiento S3 (Garage) y secretos mediante External Secrets Operator
- Despliegue de cargas de trabajo persistentes usando Longhorn sobre volumes de almacenamiento local
- Gestión de logs centralizados a través de Fluent Bit que envía registros a VictoriaLogs para análisis y auditoría
- Protección contra ataques DDoS mediante Cloudflare Tunnel y Blocky, con DNS inverso sincronizado vía ExternalDNS
- Arquitectura basada en GitOps con Argo CD como fuente de verdad única para todos los cambios del cluster
- Uso de Talos Linux como control plane que ofrece soporte nativo para Kubernetes sin necesidad de un controlador externo
- Implementación de seguridad Zero Trust a través de Cloudflare Tunnel y External Secrets Operator que sincroniza secretos desde Bitwarden
- El cluster corre en Talos Linux, lo que limita la compatibilidad con herramientas que requieren Kubernetes estándar (ej. Helm charts no compatibles)
- La infraestructura depende de servicios externos como Cloudflare y Bitwarden; si estos se desactivan o fallan, el cluster queda sin acceso externo o secretos
- No incluye un controlador de seguridad nativo en Talos, por lo que la protección contra intrusos debe realizarse a nivel de red (Firewall) y configuración de políticas
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.
Para desplegar este proyecto localmente: instala Talos Linux sobre los nodos físicos, configura MetalLB con IPs locales, despliega Envoy Gateway en cada nodo para el control de tráfico. En la nube, utiliza Cloudflare Tunnel para exponer servicios sin abrir puertos y External Secrets Operator para sincronizar secretos desde Bitwarden. Para aplicar cambios a Argo CD, crea un PR en GitHub que incluya los manifests del cluster (kubernetes/homelab/) y mergea el PR; Argo CD aplicará los cambios automáticamente. Para actualizar dependencias, ejecuta Renovate en la raíz del repositorio. Los logs se monitorean con Prometheus y Grafana a través de VictoriaLogs.
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.