homelab
Repositorio de infraestructura y GitOps para un homelab con Kubernetes, Ansible y ArgoCD sobre Debian Bookworm. Incluye gestión de red, seguridad y aplicaciones autoalojadas.
Ficha actualizada 18 sept 2026, 21:42 · upstream 18 sept 2026, 7:11 · 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 proporciona código de infraestructura como código (IaC) para construir y gestionar un homelab completo. Se centra en un clúster Kubernetes gestionado con GitOps mediante ArgoCD, utilizando kubeadm para la instalación inicial y CRI-O como runtime de contenedores en lugar de Docker. La automatización del sistema se realiza principalmente con Ansible, que provisiona hosts, configura el clúster y despliega aplicaciones desde manifestos YAML o Helm Charts almacenados en Git.
El alcance va más allá del clúster, abarcando la red completa del hogar, incluyendo un firewall OpnSense, gestión de certificados PKI offline con OpenSSL y servidores como FreeIPA. El sistema se basa en Debian Bookworm y utiliza Terraform para la creación de máquinas virtuales. La complejidad es alta, requiriendo conocimientos avanzados de Linux, redes y orquestación de contenedores.
- Automatización del despliegue de clústeres Kubernetes
- Gestión de aplicaciones mediante GitOps con ArgoCD
- Provisionamiento de infraestructura de red y seguridad (OpnSense)
- Orquestación de bases de datos relacionales y caché
- Uso de CRI-O en lugar de Docker para contenerización
- Integración completa de Ansible y ArgoCD para IaC y GitOps
- Licencia WTFPL permitiendo uso libre sin restricciones
- Soporte para virtualización con KVM y Libvirt
- Alta complejidad técnica no apta para principiantes
- Requiere entorno Debian Bookworm específico
- No incluye soporte para acceso remoto VPN o RADIUS en la lista de características completadas
- Dependencia de herramientas de línea de comandos (Python, Ansible)
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.
Se requiere Python 3 y Ansible instalados. Crear entorno virtual (.venv), activarlo e instalar dependencias desde requirements.txt y requirements.yaml. Ejecutar ansible-playbook homelab.yml tras configurar el inventario. Hardware mínimo sugerido: 4 núcleos CPU, 4GB RAM y 30GB disco según análisis técnico.
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.