Homelab
Infraestructura de homelab basada en Kubernetes con Talos Linux, gestionada mediante GitOps con ArgoCD. Incluye monitorización completa, gestión de secretos con Vault, bases de datos PostgreSQL operadas y servicios autoalojados para productividad y automatización.
Ficha actualizada 22 sept 2026, 15:36 · upstream 22 sept 2026, 14:14 · release sin release detectada
Qué es Homelab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio define una infraestructura de servidor doméstico basada en un clúster Kubernetes desplegado sobre Talos Linux, un sistema operativo inmutable diseñado para seguridad y gestión simplificada. La configuración se gestiona de forma declarativa mediante ArgoCD, que actúa como controlador GitOps para todos los componentes del clúster, asegurando consistencia entre el código fuente y el estado real del entorno.
La arquitectura incluye Cilium como proveedor de CNI, implementando balanceo de carga a nivel L2 y Gateway API. Se utilizan External DNS para gestión automática de registros en Cloudflare y Cert-Manager para provisioning de TLS. La monitorización se realiza con Kube Prometheus Stack, Gatus para dashboards de estado y Hubble para observabilidad de red.
Los servicios incluyen bases de datos PostgreSQL gestionadas mediante el operador CNPG, almacenamiento NFS dinámico, gestión de secretos con HashiCorp Vault sincronizado vía External Secrets Operator, y una suite de aplicaciones para productividad como Kanboard, Ntfy, Gitea y un dashboard unificado. Renovate automatiza las actualizaciones de dependencias.
La infraestructura está diseñada para ser escalable y segura, con políticas de red en Cilium, RBAC configurado y soporte para acceso remoto seguro mediante Tailscale.
- Automatización de despliegues y actualizaciones mediante GitOps con ArgoCD y Renovate
- Monitorización completa del clúster Kubernetes con Prometheus, Grafana y Alertmanager
- Gestión segura de secretos centralizada con HashiCorp Vault y External Secrets Operator
- Provisionamiento automático de certificados TLS y gestión de DNS con Cert-Manager y External DNS
- Despliegue de bases de datos PostgreSQL operadas mediante Cloud Native Postgres Operator
- Acceso remoto seguro a la infraestructura mediante Tailscale VPN
- Uso de Talos Linux como sistema operativo inmutable para Kubernetes, mejorando seguridad y simplificación operativa
- Implementación de Cilium como CNI con soporte para Gateway API, L2 announcements y políticas de red granulares
- Gestión GitOps completa con ArgoCD, incluyendo auto-gestión del propio controlador y ApplicationSets
- Automatización de dependencias mediante Renovate Operator integrado en el flujo de trabajo
- Observabilidad avanzada con Kube Prometheus Stack, Gatus para health checks y Hubble para tráfico de red
- Gestión de secretos descentralizada pero sincronizada con Vault usando External Secrets Operator
- Complejidad HIGH: requiere conocimientos avanzados en Kubernetes, GitOps y administración de sistemas
- Dependencia de Talos Linux: no es compatible con distribuciones estándar como Ubuntu o Debian sin adaptación
- Requiere hardware dedicado o virtualizado con al menos 4 núcleos CPU y 8GB RAM por nodo (controlplane + worker)
- No incluye Docker ni Compose: la gestión de contenedores se realiza exclusivamente a través de Kubernetes
- Configuración inicial compleja: requiere bootstrap manual de Vault, creación de secretos iniciales y configuración de DNS externo
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.
Recomendaciones de despliegue: - Hardware mínimo: 2 nodos (controlplane + worker), cada uno con al menos 4 núcleos CPU y 8GB RAM. - Talos Linux requiere instalación manual o uso de ISO oficial; no es compatible con máquinas virtuales estándar sin configuración especial. - Asegurar conectividad estable a Cloudflare para DNS externo y Cert-Manager. - Configurar políticas de red en Cilium antes de desplegar aplicaciones críticas. - Crear secretos iniciales para Vault manualmente antes de activar External Secrets Operator. - Usar ApplicationSets para despliegues repetibles y evitar configuraciones manuales.
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.