proxmox-kubernetes
Herramienta declarativa para provisionar clústeres Kubernetes en Proxmox VE usando Terraform y Kubespray. Automatiza la creación de nodos, redes internas y componentes adicionales como Helm o ArgoCD mediante variables de entrada.
Ficha actualizada 18 sept 2026, 21:23 · upstream 23 ene 2025, 18:02 · release 5.0.0
Qué es proxmox-kubernetes
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio permite desplegar infraestructura Kubernetes sobre Proxmox VE 7.x/8.x sin necesidad de Docker en el host, utilizando máquinas virtuales gestionadas por Terraform. Kubespray se instala automáticamente dentro de una VM para orquestar la red y los componentes del clúster. La configuración es totalmente declarativa a través de archivos .tfvars, donde se definen especificaciones de hardware (CPU, RAM, disco), versiones de Kubernetes (actualmente v1.29.x) y plugins de red como Calico o Cilium.
Soporta la integración con bastiones SSH para acceso seguro, gestión de claves en base64 y plantillas de Cloud-init para Ubuntu 24.04. Ofrece opciones para habilitar políticas de seguridad (PodSecurityPolicy), almacenamiento persistente (CSI drivers compatibles con OpenStack/AWS/Azure/GCP) y herramientas de CI/CD como ArgoCD o Nginx Ingress Controller.
- Despliegue rápido de clústeres Kubernetes en hardware virtualizado Proxmox para entornos de desarrollo o pruebas (QA).
- Migración de cargas de trabajo desde proveedores cloud a infraestructura local gestionada por Proxmox VE.
- Creación de nodos Kubernetes aislados con redes internas privadas para evitar exposición directa a internet.
- Automatización de la configuración de almacenamiento persistente en clústeres locales usando discos virtuales adicionales en los workers.
- Uso de Terraform y Kubespray para una gestión declarativa y reproducible de la infraestructura.
- Soporte nativo para múltiples plugins de red (Calico, Cilium, Flannel) y versiones recientes de Kubernetes.
- Configuración flexible mediante variables de entrada para ajustar recursos hardware y componentes del clúster sin editar código fuente.
- Capacidad de habilitar ArgoCD o Helm para gestionar aplicaciones de forma declarativa una vez desplegado el clúster.
- Requiere conocimientos avanzados de Terraform, Proxmox VE API y redes internas (bridges) para configurar correctamente las variables obligatorias como pm_api_token_id.
- No incluye soporte oficial ni mantenimiento activo del repositorio en GitHub; depende de la comunidad o del autor original.
- La configuración de almacenamiento persistente está limitada a drivers CSI específicos que deben estar disponibles en el entorno Proxmox.
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.
Es necesario tener instalado Terraform y acceso a la API de Proxmox VE con credenciales válidas (token ID y secret). Se recomienda usar una clave SSH privada para conectar al nodo bastión antes de ejecutar terraform apply. Asegurar que el host tenga suficiente RAM y CPU según las especificaciones definidas en las variables vm_k8s_control_plane y vm_k8s_worker.
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.