home-k8s-argo
home-k8s-argo define GitOps mediante Argo CD para un clúster Kubernetes doméstico (kube-master + workers). Gestiona aplicaciones de usuario, IA, medios y observabilidad desde GitHub sin credenciales en el repositorio.
Ficha actualizada 24 sept 2026, 8:34 · upstream 24 sept 2026, 8:29 · release sin release detectada
Qué es home-k8s-argo
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio implementa una arquitectura GitOps para un clúster Kubernetes doméstico utilizando Argo CD como gestor 'app-of-apps'. Los manifiestos residen en GitHub y se sincronizan automáticamente, separando la configuración declarativa de los secretos sensibles que se inyectan fuera de banda mediante recursos Kubernetes. La gestión centraliza el despliegue de aplicaciones autoalojadas, servidores de IA y herramientas de observabilidad.
- Gestión centralizada de un clúster Kubernetes doméstico mediante GitOps.
- Despliegue de servidores Model Context Protocol (MCP) para integración con LLMs.
- Autogestión de medios y almacenamiento (Jellyfin, MinIO/SMB).
- Observabilidad completa con Prometheus, Grafana e InfluxDB.
- Implementación de redes privadas y VPNs (WireGuard, OpenConnect).
- Automatización de flujos de trabajo con n8n y Litellm.
- Gestión declarativa sin credenciales en el repositorio Git.
- Soporte para SQLite sobre almacenamiento SMB (CIFS) sin corrupción de datos.
- Corrección específica para bucles OOM en InfluxDB en hardware limitado (8GB).
- Integración segura de MCP con VPN corporativo mediante inyección de tokens lateral.
- Arquitectura híbrida: sincronización automática (pull) y despliegue manual (push).
- Gestión de secretos declarativos separando valores sensibles de los manifiestos.
- Dependencia crítica de la creación manual de Secretos antes del primer sync.
- Algunos servicios (wg-vless-gateway, wstunnel) requieren despliegue push-based manual.
- Configuración sensible a cambios en el router (Keenetic) y filtrado DPI HTTPS.
- Requiere 4 núcleos CPU y 8GB RAM para la configuración recomendada de servicios.
- Migración de clúster implica recrear todos los Secretos 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.
Inicializar con kubectl apply en los archivos bootstrap.yaml de cada grupo. Crear todos los Secrets requeridos (ej. argocd-secret, DB passwords) antes del primer sync. Verificar que el acceso HTTPS a GitHub sea estable para Argo CD. Revisar la tabla de exclusión en bootstrap.yaml para activar servicios deshabilitados por defecto.
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.