agent
FlatRun es una plataforma open source autoadministrable para desplegar, proteger y escalar aplicaciones contenedizadas en un solo servidor o flota conectada.
Ficha actualizada 23 sept 2026, 13:35 · upstream 23 sept 2026, 13:33 · release v0.4.0-beta.2
Qué es agent
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
FlatRun permite desplegar, proteger, diagnosticar, automatizar y gestionar aplicaciones contenedorizadas en un único servidor o flota de servidores conectados. Se ejecuta directamente sobre Docker Compose y puede escalar cargas de trabajo elegibles a través de Docker Swarm o k3s.
La plataforma está diseñada para operadores que desean una clara hoja de ruta de contenedores sin sacrificar el control sobre sus servidores, archivos Compose ni datos iniciales. Se recomienda comenzar con un solo host Docker y conectar nodos adicionales cuando la escalabilidad se requiera.
El repositorio principal contiene el agente en Go, que gestiona los despliegues y sirve la API REST para la interfaz gráfica y la CLI.
- Desplegar aplicaciones web estáticas o dinámicas con Docker Compose
- Escalar cargas de trabajo mediante Docker Swarm o k3s
- Gestionar múltiples servidores conectados en una flota homogénea
- Automatizar despliegues y actualizaciones mediante GitHub Actions
- Monitoreo continuo de recursos, logs y estado de las aplicaciones
- Protección de datos con contenedores aislados y almacenamiento S3 compatible
- Todo el código está en un solo repositorio: agente, UI, CLI y herramientas de despliegue
- El modelo de archivo plano (docker-compose.yml) permite migraciones simples mediante tar
- Monitoreo nativo con OpenTelemetry que exporta métricas a cualquier backend (Prometheus, Grafana, SigNoz)
- Asistente IA integrado que analiza logs y configuración para diagnosticar problemas sin requerir conocimientos técnicos profundos
- Soporte de autenticación JWT con API keys separadas del código fuente
- La escalabilidad por defecto es manual: se requiere un administrador para habilitar Docker Swarm o k3s en cada nodo
- El almacenamiento S3 debe ser compatible con el formato de FlatRun (no todos los buckets lo soportan)
- No incluye herramientas de despliegue nativas como Kubernetes, Helm o Ansible
- La autenticación se basa en API keys y JWT, sin autenticación basada en roles o RBAC nativa
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.
Instalar el agente mediante un script de instalación (curl) que crea un servicio systemd auto-startable,El agente corre como usuario root por defecto; se recomienda crear un usuario dedicado con permisos mínimos,Configurar la API en 0.0.0.0:8090 y permitir CORS solo para las URLs permitidas (ej: localhost:5173),Para producción, usar HTTPS con certificados generados por Certbot o un CA interno,El agente requiere Docker Socket (/var/run/docker.sock) accesible; en entornos Kubernetes se debe usar el flag --docker-socket
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.