Infraestructura
Mentat esta pensado para correr en infraestructura que controlas. La referencia es deliberadamente simple: Linux con KVM, SSD adjunto, provisionamiento por Terraform y capacidad suficiente para Firecracker, Docker y servicios de plataforma en el mismo entorno privado.
Perfil de Host de Referencia
| Maquina | 8 vCPU, 32GB RAM |
| SO | Ubuntu 24.04 LTS o Linux equivalente con KVM |
| CPU | x86_64 con VT-x / soporte de KVM anidado |
| Disco Boot | 150GB SSD |
| Disco Datos | 512GB SSD |
| Forma del cluster | 3 nodos para Raft (1 lider, 2 seguidores) |
| Red | Subnet privada entre nodos |
Que Soporta Este Perfil
Este perfil esta dimensionado para workloads mixtos: servicios aislados en Firecracker, servicios existentes en Docker y agentes de plataforma por exec. Es una base practica para infraestructura privada, no una arquitectura tipo hyperscaler.
| Servicio | Driver | Estado Observado |
|---|---|---|
| StreamForge v0.11.4 | Firecracker | Cluster Raft de 3 nodos verificado |
| OxideStore | Firecracker | API S3 verificada con AWS CLI |
| API Service | Docker | Runtime de aplicacion containerizado con politica docker-hardened |
| Node Agent | Exec | Servicio de plataforma a nivel host |
Layout del Filesystem
/opt/mentat/bin/
├── mt
├── mentat-server
└── mentat-agent
/var/lib/mentat/
└── state/
/tmp/mentat/
└── firecracker/
/mnt/unikernel-volumes/
├── vector-store/
├── oxidestore/
└── otros volumenes de servicioPuertos y Modelo de Acceso
| Puerto | Servicio | Acceso |
|---|---|---|
| 22 | SSH | Externo |
| 4646 | API Mentat | Externo o VPN |
| 4647 | API Agent | Interno |
| 80/443 | Ingress | Externo |
Software Instalado
| Firecracker | v1.7.0 |
| Docker | 28.2.2 |
| KVM | /dev/kvm disponible para el usuario runtime |
Provisionamiento
Terraform es la forma recomendada de aprovisionar y repetir entornos. La nube exacta puede cambiar, pero los requisitos base son los mismos: Linux, KVM, SSD adjunto y conectividad privada entre nodos.
La arquitectura del control plane esta pensada para correr como cluster Raft. Aunque un entorno puntual quede temporalmente con un solo votante activo, el modelo operativo, la red y el provisionamiento deben seguir alineados con una topologia multi-node.
cd Terraform/
terraform init
terraform plan -var="project_id=your-project-id"
terraform apply -var="project_id=your-project-id" -auto-approveBackups
Los datos persistentes deben vivir en el disco adjunto y protegerse con snapshots regulares. La politica de referencia conserva snapshots diarios con una ventana de retencion de 7 dias.
Compilar y Publicar Binarios
cargo build --release --target x86_64-unknown-linux-musl \
--bin mt --bin mentat-server --bin mentat-agent
scp target/x86_64-unknown-linux-musl/release/{mt,mentat-server,mentat-agent} \
user@your-host:/opt/mentat/bin/