Referencia CLI

mt es la entrada operativa de Mentat. Habla conmentat-server por HTTP y cubre el ciclo normal de una plataforma privada de workloads: desplegar, inspeccionar, escalar, actualizar y recuperar.

opciones globales
mt [--server <URL>] <comando>

Opciones:
  --server <SERVER>  Direccion del servidor Mentat [default: http://127.0.0.1:4646]
  -h, --help         Mostrar ayuda

Comandos Principales

mt run <archivo.yaml>

Envia una definicion de workloads al control plane.

mt run services.yaml
mt run --server http://10.0.0.1:4646 production.yaml

mt status [job-id]

Inspecciona jobs y asignaciones. Usa un job ID para detalle.

mt status
mt status abc123-def456

mt deploy <servicio> --image <tag>

Publica una nueva imagen usando la estrategia configurada.

mt deploy api-gateway --image registry.example/api-gateway:v2
mt deploy streamforge --image streamforge:v2 --strategy canary

mt scale <servicio> <cantidad>

Cambia la cantidad objetivo de replicas de un servicio.

mt scale api-gateway 5
mt scale api-service 3

mt rollback <servicio>

Regresa un servicio a la version desplegable anterior.

mt rollback api-service

mt canary promote <servicio>

Promueve un canary a rollout completo.

mt canary promote streamforge

mt canary abort <servicio>

Aborta un canary y revierte el cambio.

mt canary abort streamforge

mt nodes

Lista nodos registrados y sus recursos disponibles.

mt nodes

mt logs <servicio>

Inspecciona logs de un servicio. Usa -f para seguir.

mt logs api-gateway
mt logs api-gateway -f

Flujo Tipico de Operacion

# Iniciar control plane y host agent
mentat-server --bind 0.0.0.0:4646
mentat-agent --kvm --server http://localhost:4646

# Enviar la definicion del stack
mt run services.yaml

# Ver que esta corriendo
mt status
mt nodes

# Cambiar un servicio de forma segura
mt deploy api-gateway --image registry.example/api-gateway:v2
mt rollback api-gateway

Salida Observada en Produccion

mt run services.yaml
$ mt run services.yaml
  scheduling 4 services...
  driver: firecracker  x2 services
  driver: exec         x1 services
  driver: docker       x1 services

  streamforge-broker x2  8ms   <- trafico real
  oxidestore        x1  6ms   <- API S3 activa
  mentat-agent      x1  2ms
  api-jarvis        x1  380ms

  all services healthy
  firecracker + docker + exec  ·  private control plane

Interfaces

TUI

mt lens --server your-host:4646

App Desktop

Mentat Desktop se conecta al API por HTTPS para monitoreo grafico y operacion del dia a dia. Sirve cuando el equipo quiere visibilidad sin vivir completamente en la terminal.

Manejo Seguro de Cambios

# Canary primero
mt deploy streamforge --image streamforge:v2 --strategy canary

# Evaluar y decidir
mt canary promote streamforge
# o: mt canary abort streamforge