gitops
Infraestructura GitOps para gestionar un clúster k3s con Argo CD, separando manifiestos de aplicaciones (apps/) de los componentes de bootstrap del clúster. Incluye gestión de secretos cifrados con SOPS+age y preparación para migración a Talos.
Ficha actualizada 22 sept 2026, 15:25 · upstream 22 sept 2026, 3:02 · release sin release detectada
Qué es gitops
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona una colección de manifiestos GitOps diseñados para gestionar aplicaciones autoalojadas en un clúster k3s utilizando Argo CD como herramienta de sincronización. La arquitectura se divide claramente entre los componentes del bootstrap (bootstrap/), que configuran el clúster y servicios críticos como Argo CD, cert-manager y Gateway, y las aplicaciones de usuario final (apps/), que son sincronizadas automáticamente por Argo CD mediante ApplicationSets.
La gestión de secretos es robusta: la mayoría de las credenciales se almacenan en Infisical para una actualización dinámica sin tocar el código, mientras que los secretos críticos del bootstrap (como claves de cifrado y tokens) están protegidos con SOPS + age. El repositorio también incluye scripts y configuraciones para backups diarios hacia Cloudflare R2 y procedimientos de recuperación ante desastres.
Además, la estructura está preparada para una futura migración a Talos Linux, un sistema operativo ligero para Kubernetes, con validaciones automatizadas en los workflows de GitHub Actions. La asignación de nombres de host sigue reglas lógicas para mantener subdominios cortos y consistentes.
- Gestión centralizada de múltiples aplicaciones (ERPNext, Mattermost, Forgejo) en un clúster k3s mediante GitOps.
- Distribución segura de secretos usando Infisical para apps críticas y SOPS+age para componentes del bootstrap.
- Preparación y validación de migración a Talos Linux con scripts de renderizado de Helm.
- Implementación de políticas de backup automatizadas (restic → Cloudflare R2) y recuperación de desastres.
- Gestión de DNS interno y externo con reglas específicas para asignar subdominios cortos.
- Separación clara entre manifiestos de bootstrap (no sincronizados por Argo CD) y aplicaciones (apps/).
- Integración nativa con Infisical para gestión dinámica de secretos sin reiniciar pods.
- Estructura lista para migrar a Talos con validaciones automáticas en GitHub Actions.
- Sistema lógico de nombres de host basado en reglas para mantener subdominios cortos.
- Mecanismos de recuperación definidos con scripts y claves cifradas almacenadas.
- Dependencia fuerte de k3s y Argo CD; no es portable a otros orquestadores sin adaptación.
- Configuración inicial compleja debido a la separación entre bootstrap/ y apps/.
- Requiere conocimientos avanzados de GitOps, SOPS, Infisical y gestión de secretos.
- Algunos servicios críticos (como cert-manager) dependen de configuraciones externas no incluidas.
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.
Despliegue en un clúster k3s existente con Argo CD instalado. Primero, descifrar los archivos cifrados en bootstrap/ usando las claves age almacenadas en recovery/. Aplicar manifiestos de bootstrap antes que apps/. Configurar correctamente Infisical para gestión de secretos y verificar la sincronización con Argo CD.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.