homelab
Infraestructura como código para clúster HashiCorp (Nomad, Consul, Vault) en Proxmox usando Terraform, Ansible y Packer. Incluye gestión de secretos, descubrimiento de servicios y orquestación de contenedores. Estado alpha.
Ficha actualizada 18 sept 2026, 21:24 · upstream 30 nov 2025, 13:57 · 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 scripts de infraestructura como código para desplegar un clúster completo de HashiCorp (Nomad, Consul y Vault) sobre una instalación Proxmox. Utiliza Packer para crear imágenes base, Terraform para provisionar máquinas virtuales declarativamente y Ansible para la configuración post-provisioning. El sistema soporta gestión de certificados personalizados a través de Vault, descubrimiento de servicios con Consul y orquestación de contenedores mediante Nomad.
El proyecto está diseñado para entornos de homelab o pruebas iniciales, aunque admite expansión hacia alta disponibilidad añadiendo más nodos. Incluye configuración para bases de datos PostgreSQL y almacenamiento S3 con MinIO. Se advierte que el proyecto se encuentra en estado alpha, por lo que puede contener errores y cambios roturantes sin aviso previo.
Es crucial entender el flujo de aprovisionamiento antes de ejecutar cualquier código, ya que algunos playbooks pueden realizar acciones destructivas e irreversibles. La documentación externa es esencial para configurar correctamente el clúster y evitar la pérdida de datos durante las operaciones de mantenimiento o reinicios.
- Orquestación de contenedores en un entorno local sin Kubernetes
- Gestión centralizada de secretos y rotación de certificados SSL/TLS
- Descubrimiento de servicios dinámico para aplicaciones microservicios
- Automatización del despliegue de infraestructura en Proxmox con Terraform
- Creación de imágenes base estandarizadas para VMs usando Packer
- Integración completa de la suite HashiCorp (Nomad, Consul, Vault)
- Gestión automatizada de certificados Let's Encrypt y CA personal
- Uso de Ansible y Terraform para una configuración declarativa y reproducible
- Soporte nativo para bases de datos PostgreSQL y almacenamiento MinIO
- Requiere unseal manual de Vault tras cada reinicio del sistema
- No soporta dependencias entre jobs en Nomad (limitación del motor)
- El agente de Vault se ejecuta con privilegios de root, aumentando la superficie de ataque
- Estado alpha con bugs conocidos y cambios potenciales en futuras versiones
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 2 núcleos CPU, 2GB RAM y 20GB disco mínimo por nodo. No es apto para producción crítica sin HA. Leer documentación antes de ejecutar playbooks destructivos. Configurar Proxmox cluster para expansión futura si se necesita alta disponibilidad.
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.