nixos-k3s
Infraestructura declarativa basada en NixOS para un clúster K3S de nodo único, gestionado mediante GitOps con Flux y Renovate, totalmente reproducible desde cero.
Ficha actualizada 18 sept 2026, 21:27 · upstream 15 may 2026, 10:17 · release sin release detectada
Qué es nixos-k3s
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio define una infraestructura como código (IaC) para desplegar un clúster Kubernetes ligero (K3S) en un solo nodo utilizando NixOS. La configuración es declarativa y reproducible gracias al uso de flakes y herramientas como nixos-anywhere y disko, que permiten instalar el sistema operativo con un único comando CLI. El repositorio integra Gitea como servidor Git auto-alojado para gestionar el estado del clúster, actuando como fuente de verdad para Flux.
La arquitectura incluye componentes críticos para la seguridad y observabilidad: Cilium para networking basado en eBPF, Cert-Manager para gestión de certificados TLS y SOPS para cifrado de secretos. Renovate automatiza las actualizaciones de dependencias del repositorio mediante pull requests. El sistema está diseñado para ser autocontenido, aunque el autor recomienda mantener un clúster separado para servicios de IA debido a consideraciones de consumo energético.
El despliegue inicial requiere una ISO de NixOS o Arch Linux (como workaround para hardware específico), y la partición del disco de datos debe configurarse manualmente. Las actualizaciones del sistema operativo se realizan mediante comandos específicos, mientras que los cambios en el directorio ./kubernetes se aplican automáticamente por Flux sin intervención manual.
- Despliegue reproducible de un clúster K3S desde cero usando una sola línea de comando con nixos-anywhere.
- Gestión de estado del clúster mediante GitOps con Flux, sincronizando el repositorio local con el estado deseado en Kubernetes.
- Automatización de actualizaciones de dependencias y configuración de seguridad con Renovate y Cilium.
- Centralización de secretos cifrados usando SOPS y agenix para una gestión segura de credenciales.
- Arquitectura declarativa completa basada en NixOS que garantiza reproducibilidad y consistencia del sistema.
- Integración nativa de GitOps con Flux, eliminando la necesidad de herramientas externas de orquestación de configuración.
- Uso de Cilium para networking avanzado basado en eBPF, proporcionando observabilidad y seguridad a nivel de red.
- Automatización de mantenimiento mediante Renovate para mantener las dependencias del repositorio actualizadas automáticamente.
- Dependencia crítica de un servidor Gitea personal o auto-alojado; no es compatible con GitOps en repositorios públicos estándar sin configuración adicional.
- Requiere particionado manual de discos de datos durante el despliegue inicial, lo que añade complejidad operativa frente a soluciones todo-en-uno.
- La configuración del sistema operativo NixOS está separada del módulo Kubernetes, lo que puede dificultar la gestión unificada en entornos heterogéneos.
- El repositorio no incluye todos los archivos de configuración; algunos están alojados en servidores privados o locales del autor.
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.
Recomendado para equipos con hardware compatible (ej. Supermicro) que utilicen ISO NixOS o Arch Linux como workaround. Asegurar particionado manual de discos de datos antes del despliegue inicial. Activar protección de ramas en Gitea durante procesos de recuperación para evitar sobrescritura de configuraciones erróneas. Mantener un clúster separado para cargas de trabajo de IA si el consumo energético es una preocupación.
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.