homelab-monorepo: Automatización Total para Homelabs

homelab-monorepo: Ecosistema de Infraestructura como Código (IaC) para Entornos Proxmox y K3s

homelab-monorepo es un repositorio integral de infraestructura como código (IaC) diseñado específicamente para la automatización, gestión y replicabilidad de entornos home lab. A diferencia de scripts aislados, este proyecto propone una metodología de "monorepo" donde se centraliza el ciclo de vida completo de la infraestructura: desde la creación de imágenes base hasta la configuración final de servicios complejos.

¿Para quién es este proyecto?

Este repositorio está orientado a entusiastas del homelab, administradores de sistemas y estudiantes de redes que busquen profesionalizar su laboratorio doméstico. Es ideal para usuarios que operan sobre Proxmox VE y desean:

• Automatizar el despliegue de clústeres de K3s en hardware variado (incluyendo Raspberry Pi).
• Gestionar entornos híbridos de Windows Server y Linux en un mismo entorno virtualizado.
• Implementar infraestructuras que puedan ser destruidas y reconstruidas de forma idéntica en minutos.
• Aprender flujos de trabajo profesionales utilizando el "tridente" de IaC: Packer, Terraform y Ansible.

Arquitectura del Sistema y Stack Tecnológico

El proyecto implementa una arquitectura de tres capas para garantizar la idempotencia en cada etapa del despliegue:

• Capa 1: Imagen (Packer): Se utiliza para generar plantillas personalizadas para Proxmox. Soporta distribuciones como Ubuntu y Rocky Linux, además de configuraciones para Windows mediante CloudBase-Init. Esto elimina la necesidad de instalar manualmente sistemas operativos en cada VM o contenedor LXC.
• Capa 2: Aprovisionamiento (Terraform): Utiliza el proveedor de Proxmox para crear recursos virtuales a partir de archivos HCL. Esta capa gestiona la asignación de CPU, memoria, redes y almacenamiento físico/virtual.
• Capa 3: Configuración (Ansible): Una vez que la infraestructura existe, Ansible toma el control para instalar paquetes, configurar servicios de red, aplicar políticas de seguridad y desplegar aplicaciones finales como paneles de control o servidores de archivos.

Funcionalidades Avanzadas y Casos de Uso

• Soporte Multi-OS: Capacidad para gestionar entornos Windows (Active Directory, Hyper-V) y Linux en un flujo de trabajo unificado.
• Clústeres K3s en ARM: Automatización específica para nodos Raspberry Pi, permitiendo ejecutar cargas de trabajo ligeras fuera del servidor principal.
• Virtualización Anidada: Configuración de entornos complejos como clústeres de Hyper-V o instancias de KVM dentro de máquinas virtuales Proxmox.
• Integración CI/CD Local: Incluye configuración para GitHub Actions Runners auto-hospedados, permitiendo ejecutar flujos de trabajo de automatización sin depender de la infraestructura pública de GitHub.

Infraestructura y Requisitos de Hardware

Aunque el software es agnóstico en cuanto a hardware específico, el repositorio está optimizado para entornos que utilicen:

• Servidores de Rack: Como los modelos Dell R610 (con configuraciones de RAID y múltiples discos).
• Nodos Edge: Raspberry Pi 3B/3B+ para servicios persistentes como DNS dinámico o monitoreo.
• Almacenamiento: Integración con sistemas NAS (como Synology) mediante protocolos iSCSI o NFS para almacenamiento compartido en clústeres.

Guía de Despliegue y Configuración

Para implementar el entorno utilizando este monorepo, se recomienda seguir el flujo lógico del proyecto:

1. Preparación: Clonar el repositorio y configurar las variables en los archivos de Terraform según la topología de red local (ej. subreds 192.168.x.x).
2. Creación de Imágenes: Ejecutar los scripts de Packer para generar las plantillas necesarias en Proxmox.
3. Aprovisionamiento: Ejecutar terraform init y terraform apply para desplegar la infraestructura base (VMs/LXC).
4. Configuración Final: Ejecutar los playbooks de Ansible para aplicar las configuraciones finales en cada nodo.

Seguridad, Limitaciones y Advertencias

⚠️ Nota Crítica: El autor advierte explícitamente que este proyecto no es apto para entornos de producción. La prioridad del repositorio es la simplicidad y la velocidad de despliegue en un entorno controlado (laboratorio).

• Hardening: No se aplican configuraciones de seguridad avanzadas por defecto; el usuario debe aplicar parches y endurecimiento manual.
• Estado de Plantillas: Algunas plantillas específicas (como Windows Server 2019) pueden requerir ajustes manuales adicionales debido a la complejidad del sistema operativo.
• Dependencias: El uso de Active Directory es una dependencia lógica para las configuraciones de infraestructura Windows incluidas.

Comparativa y Alternativas

A diferencia de scripts individuales o tutoriales paso a paso, homelab-monorepo ofrece una visión holística del ciclo de vida de la infraestructura. Mientras que herramientas como Terraform Cloud o Ansible Tower son ideales para empresas, este monorepo está diseñado para el usuario individual que busca control total sobre su hardware físico y virtual sin las complejidades de las plataformas empresariales.

Preguntas Frecuentes (FAQ)

¿Es compatible con otros hipervisores como ESXi o XCP-ng?
No directamente. La lógica de Terraform está acoplada a la API de Proxmox VE. Para otros hipervisores, se requerirían cambios significativos en los proveedores de Terraform.

¿Puedo usarlo para desplegar servicios críticos como servidores web públicos?
No se recomienda. El proyecto carece de configuraciones de seguridad estándar (firewalls avanzados, endurecimiento de kernel) necesarias para la exposición pública.

¿Qué es CloudInit y por qué se usa aquí?
Es una herramienta que permite configurar sistemas Linux durante el primer arranque (red, usuarios, SSH), permitiendo que Terraform entregue máquinas listas para usar inmediatamente después del aprovisionamiento.