dgxarley
Playbooks de Ansible para desplegar un clúster K3s heterogéneo con un nodo control x86 y cuatro nodos worker NVIDIA DGX Spark ARM64 optimizados para inferencia distribuida de LLMs, incluyendo configuración de red compleja y hardening.
Ficha actualizada 22 sept 2026, 15:35 · upstream 22 sept 2026, 13:41 · release sin release detectada
Qué es dgxarley
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona playbooks de Ansible para automatizar el despliegue de un clúster K3s heterogéneo diseñado específicamente para inferencia distribuida de modelos de lenguaje grandes (LLM). La arquitectura consta de un nodo maestro x86_64 que actúa como plano de control y servicios frontend, junto con cuatro nodos worker ARM64 basados en hardware NVIDIA DGX Spark.
La configuración abarca roles especializados para preparación del sistema operativo, instalación de K3s, gestión de cargas de trabajo (SGLang, Ollama) e infraestructura de Kubernetes (cert-manager, Prometheus). Se implementa una red compleja con VLANs, traducción de etiquetas y optimización de interconexión QSFP para alto rendimiento.
El despliegue utiliza volúmenes hostPath en el nodo maestro para persistencia, evitando sistemas de archivos distribuidos como NFS o Ceph por defecto, salvo excepciones específicas para almacenamiento de blobs. Incluye hardening de seguridad, monitoreo de UPS y configuración de red avanzada con Open vSwitch.
- Despliegue de clúster K3s en hardware mixto x86/ARM
- Configuración de inferencia distribuida para SGLang y Ollama
- Automatización de hardening de seguridad y red (VLANs, iptables)
- Gestión de infraestructura Kubernetes en bare-metal sin Docker
- Integración de servicios como Open WebUI o docling-serve
- Soporte nativo para hardware NVIDIA DGX Spark ARM64
- Roles Ansible específicos para optimización de red (MTU 9000, QSFP)
- Configuración de clúster heterogéneo x86/ARM en un solo playbook
- Hardening de seguridad y monitoreo NUT integrado
- Gestión de infraestructura K8s sin contenedores Docker (hostPath)
- Dependencia crítica de hardware específico (DGX Spark)
- Alta complejidad en configuración de red física y VLANs
- No utiliza Docker ni Compose por defecto (requiere hostPath)
- Requiere conocimientos avanzados de Ansible y K3s
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.
Ejecutar roles en orden: common, dgx_prepare, k3sserver, k8s_dgx, k8s_infra. Asegurar configuración de red física (VLANs, MikroTik) antes del despliegue. Usar archivos vault para credenciales. Verificar compatibilidad de kernel y drivers NVIDIA CDI.
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.