fleet

CLI de gestión de producción de Docker + servidor MCP

Gestiona aplicaciones Docker Compose en un solo servidor: orquestación de systemd, enrutamiento de nginx, secretos cifrados con age, monitoreo de salud, seguimiento de dependencias, flujos de trabajo de Git y un servidor MCP para operaciones asistidas por IA.

Documentación -- npm -- GitHub

Arquitectura

graph TD
    CLI["fleet CLI"]
    TUI["TUI Dashboard"]
    MCP["MCP Server"]
    BOT["fleet-bot (Go)"]

    CLI --> Core
    TUI --> Core
    MCP --> Core
    BOT -->|"via MCP"| Core

    subgraph Core["Core Modules"]
        Registry["Registry"]
        Docker["Docker Compose"]
        Systemd["systemd"]
        Nginx["nginx"]
        Secrets["Secrets Vault"]
        Health["Health Checks"]
        Git["Git / GitHub"]
        Deps["Dependency Monitor"]
    end

    Docker --> Containers["Containers"]
    Systemd --> Services["systemd Services"]
    Nginx --> Proxy["Reverse Proxy"]
    Secrets --> Vault["vault/*.age"]
    Secrets --> Runtime["/run/fleet-secrets"]
    Health --> Alerts["Telegram / iMessage"]

Cada aplicación Docker Compose se registra con su ruta de composición, dominios, puerto y nombres de contenedor. Fleet genera unidades de systemd para que las aplicaciones se inicien al arrancar en el orden correcto. Los secretos se cifran en reposo con age y se descifran en un tmpfs al arrancar.

Related MCP server: coolify-mcp

Instalación

npm install -g @matthesketh/fleet

Requiere Node.js 20+, Docker Compose v2, systemd, nginx y age. Consulta la guía de configuración completa para más detalles.

Características principales

Despliegue y gestión de aplicaciones -- fleet deploy <app-dir> registra, construye e inicia una aplicación en un solo comando. Controla los servicios con start, stop, restart y logs.

Secretos cifrados -- Almacén cifrado con age con copias de seguridad automáticas, validación previa al sellado, detección de desviaciones y reversión atómica. Se descifran en tmpfs al arrancar: los secretos nunca tocan el disco.

Enrutamiento de Nginx -- Genera bloques de servidor proxy, SPA o Next.js con fleet nginx add. Prueba y recarga de configuración automática.

Monitoreo de salud -- Verificaciones de tres capas (systemd + contenedor + HTTP) con fleet health. El comando watchdog se ejecuta mediante cron y envía alertas en caso de fallo.

Escaneo de dependencias -- Detecta paquetes obsoletos, CVEs (vía OSV), actualizaciones de imágenes de Docker y fin de vida útil (EOL) del tiempo de ejecución en todas las aplicaciones registradas.

Flujos de trabajo de Git -- Integra aplicaciones en GitHub, gestiona ramas, PRs y lanzamientos desde la CLI.

Panel interactivo -- Ejecuta fleet solo para iniciar una TUI de pantalla completa con estado en tiempo real.

Consulta la referencia de la CLI para ver la lista completa de comandos.

Flujo de secretos

graph LR
    Import["fleet secrets import"]
    Set["fleet secrets set"]

    Import --> Encrypt["age encrypt"]
    Set --> Encrypt

    Encrypt --> Vault["vault/*.age"]
    Vault -->|"boot / fleet secrets unseal"| Decrypt["age decrypt"]
    Decrypt --> Runtime["/run/fleet-secrets (tmpfs)"]
    Runtime -->|"env_file / secrets"| Containers["Docker Containers"]

    Runtime -->|"fleet secrets seal"| Encrypt
    Vault -.->|"drift detection"| Runtime

Los secretos se importan o establecen individualmente, se cifran con age y se almacenan en el almacén. Al arrancar (o manualmente), se descifran en un montaje tmpfs al que hacen referencia los contenedores de Docker. El sellado vuelve a escribir los cambios en tiempo de ejecución en el almacén. La detección de desviaciones compara el almacén frente al tiempo de ejecución para detectar cambios no guardados.

Flujo de despliegue

graph TD
    Deploy["fleet deploy app-dir"]
    Deploy --> Register{"Already\nregistered?"}
    Register -->|No| Add["Register app"]
    Register -->|Yes| Build
    Add --> Build["docker compose build"]
    Build --> Start{"Service\nrunning?"}
    Start -->|No| StartSvc["systemctl start"]
    Start -->|Yes| Restart["systemctl restart"]
    StartSvc --> Healthy["App deployed"]
    Restart --> Healthy

Servidor MCP

Fleet expone 36 herramientas a través del Protocolo de Contexto de Modelo para la gestión de servidores asistida por IA. Ejecuta fleet mcp para iniciar el servidor stdio, o instálalo en Claude Code:

sudo fleet install-mcp

Las herramientas cubren toda la superficie: ciclo de vida de la aplicación, secretos, nginx, Git, verificaciones de salud y monitoreo de dependencias. Consulta la documentación de MCP para ver la lista completa de herramientas.

fleet-bot

Un bot complementario en Go (bot/) que proporciona gestión remota del servidor a través de Telegram o iMessage. Ejecuta sesiones de Claude Code con acceso a las herramientas MCP de fleet para operaciones manos libres.

Consulta la documentación del bot para obtener instrucciones de configuración.

Desarrollo

git clone https://github.com/wrxck/fleet.git
cd fleet
npm install
npm test          # vitest
npm run build     # compile TypeScript to dist/
npm run dev       # run with tsx (no build needed)

Licencia

MIT