Deployado CLI

Despliega y administra tus aplicaciones desde la línea de comandos. Disponible para macOS y Linux.

Instalación

Instalación rápida (Recomendada)

Ejecuta este comando en tu terminal. Detecta automáticamente tu sistema operativo y arquitectura, verifica el checksum SHA-256 e instala en /usr/local/bin (o en ~/.local/bin si no tienes permisos de escritura). Vuelve a ejecutarlo para actualizar.

Terminal 
$ curl -sSfL https://deployado.com/cli/install.sh | sh

Plataformas soportadas:

macOS (Intel & Apple Silicon) Linux (x86_64 & ARM64)

Opciones de instalación

Instalar una versión específica:

Terminal 
$ curl -sSfL https://deployado.com/cli/install.sh | sh -s -- --version 0.3.0

Instalar en un directorio personalizado:

Terminal 
$ curl -sSfL https://deployado.com/cli/install.sh | sh -s -- --dir ~/.local/bin

Descarga manual

Los archivos precompilados y sus checksums se sirven desde deployado.com. El número de la versión más reciente está en /downloads/cli/latest . 

https://deployado.com/downloads/cli/<version>/deployado_<version>_<darwin|linux>_<amd64|arm64>.tar.gz
https://deployado.com/downloads/cli/<version>/checksums.txt

Verificar instalación

Terminal 
$ deployado version

Autenticación

Inicia sesión con tu cuenta de Deployado. El CLI muestra una URL y un código corto, abre tu navegador y guarda el token resultante como un perfil con nombre.

Terminal 
$ deployado auth login

¿Trabajas con varias cuentas (por ejemplo staging y producción)? Revisa los comandos de perfiles en Autenticación y perfiles .

Nota: El inicio de sesión del CLI es independiente de los tokens de API. El servidor MCP y la API REST usan en su lugar un token creado en Configuración → Tokens de API.

Inicio rápido

# 1. Inicia sesión en tu cuenta $ deployado auth login
# 2. Ve al directorio de tu proyecto $ cd my-app
# 3. Launch — detecta tu stack, crea la app y despliega $ deployado launch
# 4. Si algo no se ve bien, ejecuta el checklist de diagnóstico $ deployado doctor <app-id>

Usar el CLI desde un agente de IA

  • Usa --json donde exista (doctor, releases logs, db query, apps list, apps update, db list, db show, domains list, projects list) y procesa esa salida en lugar de las tablas.
  • doctor --json termina con 0 cuando todas las revisiones pasan, 1 cuando alguna falla y 2 cuando no se encuentra la app.
  • Ejecuta deployado <comando> --help para descubrir todos los flags; siempre está al día con la versión instalada.
  • Los comandos que borran o sobrescriben datos piden confirmación; usa --force (o -f) solo cuando el usuario lo haya aprobado.
  • Para asistentes compatibles con MCP, el Servidor MCP expone las mismas operaciones como herramientas.

Comandos

Ejecuta deployado --help para ver todos los comandos, o deployado <command> --help para detalles de un comando específico.

Diagnosticar una app

Empieza aquí cuando una app falla. doctor corre un checklist fijo y muestra una pista por cada revisión que falla.

$ deployado doctor <app-id>

Revisa el despliegue, el último build, la salud del servidor, las instancias, la prueba HTTP, los logs y las variables de entorno

$ deployado doctor <app-id> --watch --interval 10

Vuelve a correr el checklist cada N segundos durante un incidente (Ctrl-C para salir)

$ deployado doctor <app-id> --deep

Revisa más líneas de logs y usa un timeout HTTP más largo

$ deployado doctor <app-id> --json

Salida legible por máquinas. Código de salida 0 = OK, 1 = falló una revisión, 2 = app no encontrada

$ deployado ps

Muestra todos los despliegues en ejecución y su estado

$ deployado ps <app>

Muestra el estado detallado de una app

Desplegar y hacer rollback

Publica código nuevo y deshaz un release con problemas.

$ deployado launch

Detecta tu stack, crea la app y lanza su primer despliegue

$ deployado deploy <app-id>

Lanza un despliegue (opcionalmente --branch <nombre> o --commit <sha>)

$ deployado deploy <app-id> --watch

Sigue el despliegue: muestra los logs de build y luego los de ejecución hasta que quede sano o falle

$ deployado deploy <app-id> --watch --no-build-logs --no-runtime-logs

Sigue el despliegue solo con actualizaciones de estado (salida más limpia en CI)

$ deployado rollback <app-id>

Haz rollback al release anterior

$ deployado rollback <app-id> --list

Lista los releases recientes con sus IDs completos

$ deployado rollback <app-id> --release <release-uuid> --watch

Haz rollback a un release específico y sigue el despliegue

$ deployado up --dry-run

Previsualiza un stack de varios servicios desde deployado.yaml; quita --dry-run para aplicarlo

Builds y releases

Lee la transcripción del build de cualquier release.

$ deployado releases logs <release-id>

Muestra la transcripción del docker build (funciona aunque el build siga en curso)

$ deployado releases logs <release-id> --tail 50

Muestra solo las últimas N líneas

$ deployado releases logs <release-id> --json

Payload crudo: logs más estado y tiempos

Logs, exec y shell

Revisa por dentro una app en ejecución.

$ deployado logs <app-id>

Muestra las últimas 100 líneas de logs de ejecución

$ deployado logs <app-id> -n 500

Muestra las últimas N líneas

$ deployado logs <app-id> -f

Sigue la salida de logs en tiempo real

$ deployado exec <app> -- <command>

Ejecuta un comando puntual en el contenedor y termina

$ deployado ssh <app>

Abre una shell interactiva en el contenedor

$ deployado ssh <app> -- ls -la /app

Ejecuta un solo comando no interactivo

Apps, proyectos y dominios

Inspecciona y configura tus apps.

$ deployado apps list

Lista las apps (--project <id> para filtrar, --json)

$ deployado apps show <app-id>

Muestra los detalles de una app

$ deployado apps update <app-id> --health-check-path /health

Actualiza la configuración (también --port, --branch, --auto-deploy, --deploy-gate, --auto-rollback, --read-only-root, ...)

$ deployado apps delete <app-id>

Elimina una app (-f omite la confirmación)

$ deployado projects list

Lista los proyectos

$ deployado domains list <app-id>

Lista los dominios de una app

Variables de entorno

Administra la configuración de ejecución y de build.

$ deployado env list <app-id>

Muestra todas las variables de entorno

$ deployado env set <app-id> KEY=value KEY2=value2

Define una o más variables (--scope build para tiempo de build)

$ deployado env unset <app-id> KEY

Elimina una variable de entorno

$ deployado env import <app-id> .env --dry-run

Previsualiza la importación de un archivo .env; quita --dry-run para aplicarla

Bases de Datos

db es un alias de database. query y psql --app corren en el servidor de base de datos, así que no necesitas psql local ni un túnel.

$ deployado db list

Lista las bases de datos

$ deployado db create --name mydb

Crea una base de datos PostgreSQL

$ deployado db link <database-id> --to <app-id>

Conecta una base de datos a una app (define DATABASE_URL)

$ deployado db query --app <app> "SELECT count(*) FROM users"

Ejecuta una sentencia SQL y muestra el resultado

$ deployado db query --app <app> --json --readonly "SELECT id, email FROM users LIMIT 5"

Filas como arreglo JSON, en una transacción de solo lectura

$ deployado db psql --app <app>

Sesión SQL interactiva contra la base de datos de la app (disponible --readonly)

$ deployado db restore --app <app> --to <release-version|snapshot-id>

Restaura el snapshot pre-migración de un release, o un snapshot por id. Sobrescribe la base de datos (--no-drop, --force)

$ deployado db import <database-id> --file dump.sql

Importa un dump SQL a una base de datos

Autenticación y perfiles

Las credenciales se guardan como perfiles con nombre en ~/.config/deployado/config.json. Precedencia: el flag --profile, luego DEPLOYADO_PROFILE y al final el perfil activo.

$ deployado auth login

Inicia sesión desde tu navegador (código de dispositivo)

$ deployado auth login --profile staging

Inicia sesión y guárdala como un perfil con nombre

$ deployado auth list

Lista los perfiles guardados (el activo aparece marcado con *)

$ deployado auth switch <profile>

Cambia el perfil activo

$ deployado auth status

Muestra la cuenta asociada al perfil activo

$ deployado --profile staging apps list

Ejecuta un solo comando con otro perfil

$ DEPLOYADO_PROFILE=staging deployado apps list

Selecciona el perfil con una variable de entorno

$ deployado auth logout

Elimina el perfil activo (--all elimina todos los perfiles)

¿Necesitas Ayuda?

Si encuentras algún problema, estamos aquí para ayudar.

Contactar Soporte