homelab-gitops-k3s
Cluster de Kubernetes con k3s gestionado por FluxCD GitOps y Ansible para homelab.
Ficha actualizada 22 sept 2026, 18:52 · upstream 22 sept 2026, 18:36 · release 2026.9.0
Qué es homelab-gitops-k3s
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio configura un cluster único de Kubernetes utilizando k3s, gestionado mediante el framework GitOps FluxCD. Se implementa una arquitectura orientada a la automatización con Ansible, incluyendo despliegue seguro con SOPS y Age, redirección de DNS con Cloudflare Tunnel, certificados SSL con cert-manager, capacidad HA con kube-vip, networking moderno con Cilium, repositorios preparados para Renovate y GitHub Actions integrados. El sistema incluye un devshell basado en nix flake para mantener versiones consistentes entre herramientas.
- Despliegue de aplicaciones web (Next.js) en entornos Kubernetes con GitOps
- Automatización de infraestructura con Ansible y templates
- Gestión segura de secretos mediante SOPS y Age
- Redirección de DNS hacia el cluster desde la red local
- Certificados SSL automáticos con cert-manager
- Escalabilidad horizontal con kube-vip para control plane
- Networking moderno con Cilium en clusters k3s
- Gestión de dependencias con Renovate y GitHub Actions
- Implementación opinativa de Flux desde el template del Home Operations Community
- Seguridad reforzada mediante SOPS para secretos y Age para claves privadas
- Redirección de DNS hacia el cluster desde la red local con split-horizon
- Certificados SSL automáticos con cert-manager y Cloudflare
- Capacidad HA en control plane mediante kube-vip
- Networking moderno con Cilium en lugar de CNI tradicional
- No soporta Docker ni Helm charts como mecanismo principal de despliegue
- Depende de un DNS externo configurado correctamente para split-horizon
- La redirección de DNS requiere configuración manual en el servidor DNS del hogar
- El cluster es de una sola instancia sin replicación entre nodos
- No incluye herramientas de observabilidad nativas como Prometheus o Grafana
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.
Para desplegar: asegúrate de tener un dominio Cloudflare, un DNS con split-horizon (ej. Pi-hole), y una clave SSH sin passphrase en los nodos. Ejecuta `just kube install` para instalar k3s con Ansible, luego `flux bootstrap` para inicializar Flux. Verifica que SOPS esté configurado correctamente antes de ejecutar el bootstrap. Para producción, cambia a certificados de Let's Encrypt en modo production y activa la redirección de DNS hacia los IPs del cluster.
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.