cli
CLI oficial para automatizar despliegues y operaciones de aplicaciones FlatRun en servidores FlatRun. Gestiona Docker Compose, imágenes, contenedores y servicios mediante comandos estructurados que abstraen la API subyacente.
Ficha actualizada 27 sept 2026, 22:41 · upstream 27 sept 2026, 22:16 · release v0.4.0
Qué es cli
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
FlatRun CLI es la interfaz de línea de comandos oficial para gestionar aplicaciones desplegadas en la plataforma FlatRun. Funciona como capa de automatización que envuelve la API del panel de control, permitiendo operaciones complejas desde el terminal sin necesidad de acceso directo a la infraestructura subyacente.
La herramienta soporta múltiples arquitecturas (amd64 y arm64) y sistemas operativos (Linux y macOS). Incluye gestión completa de despliegues: creación desde imágenes, actualización de contenedores, ejecución de acciones predefinidas como migraciones de base de datos, y comandos ad-hoc dentro de los contenedores. La CLI también gestiona perfiles de configuración, autenticación segura sin exponer credenciales en historial, y generación de terminales con colores adaptativos.
El diseño sigue patrones modernos de CLIs: salida JSON para automatización, tablas legibles para humanos, soporte de shells (bash, zsh, fish, powershell) y comandos `--plan` para previsualizar cambios antes de aplicarlos. Incluye verificación de integridad mediante checksums SHA-256 en la instalación.
- Desplegar aplicaciones FlatRun desde imágenes Docker directamente desde CI/CD sin tocar el panel web
- Ejecutar migraciones de base de datos MySQL dentro de contenedores tras un despliegue
- Gestionar múltiples entornos (producción, staging) mediante perfiles con tokens y URLs distintas
- Automatizar operaciones de mantenimiento: reinicios, reconstrucciones, actualizaciones de imágenes
- Auditar cambios antes de aplicarlos usando el modo `--plan` para despliegues destructivos
- Soporte nativo para arquitecturas amd64 y arm64 en Linux y macOS sin reempaquetado manual
- Autenticación segura mediante stdin para evitar exponer contraseñas en historial de shell
- Salida JSON consistente con `--json` para integración con scripts y herramientas de CI/CD
- Verificación automática de checksums SHA-256 durante la instalación desde GitHub Releases
- Comandos `--plan` que muestran cambios sin aplicarlos, permitiendo revisiones seguras
- Requiere acceso a un servidor FlatRun activo con panel configurado (no es una herramienta de orquestación independiente)
- No incluye Dockerfile ni soporte directo para construir imágenes desde el repositorio
- Dependencia del agente FlatRun en el lado del servidor para operaciones remotas
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 mediante script oficial con verificación de checksums SHA-256. Configurar perfiles con `flatrun profile add` usando variables de entorno o archivos JSON. Para CI/CD, usar `--json` en todos los comandos y `--plan` antes de operaciones destructivas. Verificar conectividad con `flatrun health`. Actualizar con `flatrun update --check` para evitar sobrescribir versiones personalizadas.
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.