#SANDBOXES
Una máquina Linux.Por API, por segundo.
Una máquina Ubuntu aislada que inicias, usas y detienes. Corre código que escribió un agente, compila un proyecto, previsualiza una web o maneja un navegador.
#QUÉ RECIBES
Tres tamaños
2 vCPU y 4 GB, 4 vCPU y 8 GB, u 8 vCPU y 16 GB. La máquina es privada del sandbox: no ve tu cuenta de Zavu ni tus otros sandboxes.
Comandos y archivos
Corre un comando de shell y recibe su código de salida y su salida, o inícialo en segundo plano. Lee y escribe archivos de hasta 5 MiB.
Puertos, SSH y escritorio
Dale a un puerto una URL HTTPS, conéctate por SSH con tu propia llave, o abre la pantalla de la máquina o su navegador en una pestaña.
Copias y snapshots
Copia un sandbox con su disco, o guarda el disco con un nombre y arranca sandboxes nuevos desde él. Un snapshot se puede compartir con otro equipo.
Entornos guardados
Conjuntos de variables de entorno con nombre, guardados cifrados, para arrancar un sandbox por nombre.
Se detiene solo
Después del timeout que definas, una hora por defecto. Un sandbox detenido conserva su disco 14 días y se puede reanudar.
#INICIAR, CORRER, DETENER
import Zavudev from "@zavudev/sdk"
const zavu = new Zavudev({ apiKey: process.env.ZAVUDEV_API_KEY })
const { sandbox } = await zavu.sandboxes.create({
size: "default",
timeoutSeconds: 1800,
})
// No need to wait for "running": calls made while it starts wait for it.
await zavu.sandboxes.files.write(sandbox.id, {
path: "main.py",
content: "print(2 + 2)\n",
})
const { result } = await zavu.sandboxes.commands.run(sandbox.id, {
command: "python3 main.py",
})
console.log(result?.exitCode, result?.stdout) // 0 "4\n"
// Billing ends here. The disk is kept 14 days.
await zavu.sandboxes.stop(sandbox.id)#CUÁNTO CUESTA
- 01
Por segundo, mientras corre
$0.0225, $0.045 o $0.09 la hora según el tamaño, con un mínimo de un minuto por ejecución, más $0.01 cada vez que uno se crea, se reanuda o se copia.
- 02
Nada mientras está detenido
El cobro termina cuando llamas a stop. El disco se conserva 14 días sin costo.
- 03
$0.07 al día por snapshot
Un snapshot guardado se cobra por día iniciado mientras lo conserves. Un equipo guarda hasta 20.
#ANTES DE CONSTRUIR ENCIMA
- Los sandboxes requieren un plan pago. En Free, crear o reanudar uno se rechaza con 402 paid_plan_required.
- Requieren una API key live. Una key de test puede leer, detener y borrar sandboxes, pero no iniciar uno ni correr comandos.
- Un equipo corre hasta 10 sandboxes a la vez e inicia hasta 200 al día. Crear, reanudar y copiar cuentan como un arranque cada uno.
- El uso se cobra de tu saldo prepago. Un sandbox en ejecución se detiene cuando el saldo o tu tope de gasto mensual ya no cubren 15 minutos más.
- Un comando en primer plano espera hasta 120 segundos. Lo que tarde más va en segundo plano y se consulta.
- Un sandbox efímero nunca guarda su disco: detenerlo borra todo, y no se puede reanudar ni copiar.
Inicia uno por cerca de un centavo.
El quickstart crea una máquina, corre un archivo en ella y la detiene.