infrastructure
Infraestructura como código basada en GitOps para una plataforma autoadministrada con Talos, Kubernetes y Flux.
Ficha actualizada 23 sept 2026, 2:57 · upstream 23 sept 2026, 2:29 · release sin release detectada
Qué es infrastructure
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio contiene la configuración de infraestructura como código para una plataforma self-hosted construida alrededor de Talos, Kubernetes y GitOps. Combina el bootstrap del cluster, la gestión de aplicaciones, el manejo de secretos y las operaciones diarias en un solo repositorio.
La arquitectura se divide en componentes principales: Talos (para el bootstrapping del nodo físico), Kubernetes con GitOps para la entrega de aplicaciones, SOPS con Age para el manejo seguro de secretos, y Terraform para provisionamiento fuera de Kubernetes. El flujo operativo principal es GitOps a través de Flux, con comandos de Taskfile para operaciones diarias.
Los clusters principales son 'main', 'test' y 'registry'. La infraestructura se mantiene mediante workflows de GitHub Actions enfocados en mantenimiento del repositorio (renovate, label-sync, labeler) y despliegues manuales de merge batch.
- Automatización del bootstrapping de clusters Talos con Kubernetes
- Gestión de infraestructura como código mediante Terraform para recursos no K8s
- Entrega de aplicaciones a través de GitOps con Flux y Helmfile
- Manejo seguro de secretos mediante SOPS con Age keys
- Operaciones diarias controladas a través del Taskfile
- Monitoreo y sincronización de estado entre clusters
- Arquitectura GitOps completa con Flux como mecanismo principal de entrega de aplicaciones
- Uso de Talos para el bootstrapping de nodos físicos y control plane
- Seguridad mediante SOPS con Age keys, evitando secretos en repositorios públicos
- Estructura modular clara: talos/, bootstrap/, kubernetes/, terraform/, ansible/
- Soporte multi-cluster (main, test, registry) con GitOps entrypoints separados
- Flujo de trabajo híbrido: GitOps para apps principales y Terraform para infraestructura externa
- Dependencia crítica de Talos como nodo físico; no es un cluster nativo K8s
- El bootstrapping inicial requiere comandos manuales (task talos:bootstrap)
- La sincronización entre clusters se realiza mediante Flux, lo que puede ser lento
- No incluye herramientas de observabilidad o monitoreo en este repositorio
- Depende de la disponibilidad de herramientas como krew, task y sops
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.
Instala las herramientas requeridas con: task workstation:direnv, task ansible:deps,Genera una clave de Age para decryptar secretos antes de operar clusters:,task sops:age-keygen,Valida la seguridad antes del commit con: task repository:validate,Para despliegues manuales, usa: task flux:helmfile cluster=<nombre> y task flux:reconcile cluster=<nombre>,La sincronización entre clusters se realiza con: task flux:ks-sync cluster=<nombre>
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.