home-ops
Infraestructura doméstica completa gestionada con Kubernetes (Talos) y GitOps (ArgoCD). Incluye aprovisionamiento con Terraform, almacenamiento Ceph/NFS, monitorización Prometheus y gestión de secretos vía Bitwarden.
Ficha actualizada 22 sept 2026, 15:35 · upstream 22 sept 2026, 13:07 · release sin release detectada
Qué es home-ops
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona una solución integral para la infraestructura de hogar basada en Kubernetes, utilizando Talos como sistema operativo ligero para nodos bare-metal. La arquitectura se gestiona mediante GitOps con ArgoCD, asegurando que el estado del clúster esté siempre sincronizado con el código fuente almacenado en el repositorio.
El aprovisionamiento inicial se realiza con Terraform para la configuración de DNS en Cloudflare y Bitwarden Secrets Manager para la gestión segura de credenciales. El clúster incluye componentes críticos como Cilium para red, Rook-Ceph para almacenamiento persistente, Keycloak para autenticación OIDC y kube-prometheus-stack para observabilidad.
La estructura del repositorio está organizada por categorías (core, system, default, games, home-automation) bajo el directorio cluster, permitiendo una gestión modular de aplicaciones. Se incluyen herramientas de desarrollo como devcontainers y hooks pre-commit para garantizar la calidad del código y evitar fugas de secretos.
- Gestión centralizada de servicios domésticos (Jellyfin, Gitea, n8n) mediante GitOps
- Infraestructura segura con autenticación SSO vía Keycloak y gestión de secretos en Bitwarden
- Almacenamiento persistente escalable con Rook-Ceph o NFS para QNAP
- Monitorización completa del clúster con Prometheus, Grafana y alertas
- Provisionamiento automatizado de nodos bare-metal con Talos y Terraform
- GitOps puro: ArgoCD sincroniza automáticamente todas las aplicaciones desde el repositorio
- Gestión de secretos segura mediante External Secrets Operator y Bitwarden Secrets Manager
- Almacenamiento híbrido con Rook-Ceph para datos calientes y NFS para almacenamiento en frío
- Red definida por Cilium con balanceo de carga L2 y CNI moderno
- Autenticación centralizada con Keycloak habilitando SSO para todas las aplicaciones
- Provisionamiento automatizado de DNS y certificados SSL mediante Terraform y cert-manager
- Requiere hardware bare-metal o virtualización avanzada compatible con Talos
- El proceso de inicialización es complejo y requiere conocimientos avanzados de Kubernetes
- La limpieza de discos para Rook-Ceph es destructiva y debe realizarse antes del despliegue
- No incluye un clic; todo el proceso de instalación debe ejecutarse manualmente siguiendo los scripts
- Dependencia de servicios externos como Cloudflare para DNS y Bitwarden para secretos
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.
Requiere nodos bare-metal con Talos, dominio en Cloudflare y acceso a Bitwarden Secrets Manager. Ejecutar task bootstrap:kubernetes tras configurar .envrc con BWS_TOKEN, KUBECONFIG y TALOSCONFIG. Validar discos limpios antes de Rook-Ceph. Inicializar DNS y certificados SSL antes del primer despliegue.
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.