home-ops
Monorepositorio GitOps para clústeres Kubernetes domésticos (homelab) usando Talos como SO de nodo y Flux para sincronización automática desde Git.
Ficha actualizada 22 sept 2026, 15:14 · upstream 22 sept 2026, 12:15 · release 2026.9.0
Qué es home-ops
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio es un monorepo diseñado para gestionar múltiples clústeres Kubernetes en entornos domésticos, siguiendo estrictas prácticas de Infrastructure as Code (IaC) y GitOps. Utiliza herramientas como Ansible, Kubernetes, Flux, Renovate y GitHub Actions para automatizar el ciclo de vida de la infraestructura y las aplicaciones.
El enfoque técnico se basa en Talos Linux como sistema operativo del nodo, lo que permite una gestión simplificada del controlador del plano y un arranque seguro. El almacenamiento persistente se gestiona mediante Longhorn para bloques dentro del clúster y TrueNAS SCALE externo para archivos compartidos (NFS/SMB) y copias de seguridad.
La arquitectura incluye componentes críticos como cert-manager para certificados SSL, cilium para redes CNI, external-dns para gestión dinámica de DNS con Cloudflare, y external-secrets para la gestión segura de secretos usando Bitwarden. Renovate automatiza las actualizaciones de dependencias creando PRs automáticamente.
- Gestión centralizada de múltiples clústeres Kubernetes (main en Francia, dev en Canadá) desde un único repositorio Git.
- Automatización completa del ciclo de vida de aplicaciones y configuración mediante Flux y Renovate sin intervención manual.
- Implementación de almacenamiento persistente distribuido con Longhorn para bases de datos y aplicaciones stateful.
- Gestión segura de secretos utilizando Bitwarden como backend a través de External Secrets Operator.
- Configuración de DNS dinámico automático sincronizando registros con Cloudflare mediante external-dns.
- Adopción de prácticas GitOps maduras con Flux v2 y Renovate para actualizaciones automáticas de dependencias.
- Integración nativa con Talos Linux para nodos Kubernetes, facilitando la gestión del plano de control.
- Gestión de secretos descentralizada y segura usando Bitwarden como proveedor externo de secretos.
- Arquitectura híbrida que combina almacenamiento en bloque (Longhorn) y archivos (TrueNAS SCALE).
- Configuración de DNS automático con external-dns sincronizando registros a Cloudflare.
- Alta complejidad técnica: requiere conocimientos avanzados de Kubernetes, Talos y GitOps.
- Dependencia de servicios cloud externos (Bitwarden, OVH, Hetzner) para funcionalidades críticas.
- No soporta despliegue one-click; instalación manual paso a paso requerida.
- Requiere hardware específico compatible con Talos Linux (arquitectura x86_64 principalmente).
- Gestión de múltiples clústeres puede ser compleja para entornos pequeños o principiantes.
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 solo para usuarios avanzados. Requiere instalación manual de Talos en nodos, configuración del clúster con kubectl, y despliegue de Flux y Renovate. Es necesario configurar Bitwarden como backend de secretos antes de usar External Secrets. No apto para entornos sin acceso a la nube o sin conocimientos de Kubernetes avanzado.
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.