Español
Empezar

Agent Sandboxes Volúmenes que sobreviven al sandbox

Volúmenes: un disco que sobrevive a sus sandboxes

Algunos datos deben durar más que un sandbox, o leerlos muchos: un dataset, una caché de paquetes, los pesos de un modelo. Un volumen los guarda: un disco fuera de todo sandbox, montado en un path al crear un sandbox y conservado cuando el sandbox se elimina.

Cómo funcionan los volúmenes de los sandboxes

Un volumen es un disco de 1 a 1000 GiB en uno de nuestros servidores, una imagen ext4 dispersa fuera de todo sandbox. Lo creas con create_volume y lo montas al crear un sandbox, en un path absoluto como /data. Un sandbox monta hasta 4 volúmenes, y se ejecuta en el servidor que los tiene.

Un sandbox monta un volumen de lectura y escritura, o cualquier número de sandboxes lo montan de solo lectura, nunca las dos cosas a la vez. Un sandbox conserva su montaje hasta que se elimina: pausarlo o detenerlo conserva el montaje. Así que, para pasar un volumen del sandbox que lo llenó a los que lo leen, elimina el que escribe y crea los lectores con montajes de solo lectura. Un fork de un sandbox que monta volúmenes de solo lectura también los monta.

Cuando se elimina un sandbox, el volumen se queda con sus archivos, y el siguiente sandbox que lo monta los encuentra como se dejaron. Cada volumen informa de los bytes que usa y de los sandboxes que lo montan, y eliminarlo se rechaza mientras un sandbox lo monta. La guía de volúmenes tiene cada llamada y cada campo.

from pethost.sandboxes import Mount, Sandboxes

sandboxes = Sandboxes()  # lee PETHOST_TOKEN
volume = sandboxes.create_volume("datasets", size_gib=50)

writer = sandboxes.create_sandbox(mounts=[Mount(volume_id=volume.volume_id, path="/data")])
sandboxes.run_command(writer.sandbox_id, command="seq 1 1000000 > /data/numbers.txt")
sandboxes.delete_sandbox(writer.sandbox_id)  # el volumen se queda

readers = [
    sandboxes.create_sandbox(mounts=[Mount(volume_id=volume.volume_id, path="/data", read_only=True)])
    for _ in range(3)
]
print(sandboxes.run_command(readers[0].sandbox_id, command="wc -l /data/numbers.txt").stdout)
# 1000000 /data/numbers.txt
vol=$(pethost sandbox volume new datasets --size 50)
pethost sandbox new --name writer --mount "$vol:/data"
pethost sandbox run writer -- 'seq 1 1000000 > /data/numbers.txt'
pethost sandbox rm writer -y                 # el volumen se queda
pethost sandbox new --mount "$vol:/data:ro"  # uno que lee

Qué saber antes de confiar en un volumen

Un volumen vive en el disco de un servidor y no se copia a ningún otro sitio. Si ese servidor se pierde, el volumen se pierde con él, y los sandboxes que lo montaban también lo pierden. Guarda en otro lugar una copia de todo lo que no puedas perder. El propio disco de un sandbox, en cambio, se copia al almacenamiento de objetos un minuto después de que el sandbox se detiene.

Un volumen también ata sus sandboxes a su servidor. Un sandbox detenido que monta uno solo vuelve a iniciarse allí, mientras que un sandbox sin volúmenes puede iniciarse en otro servidor con espacio. Un fork se rechaza mientras el sandbox monta un volumen de lectura y escritura. Un volumen aún no puede cambiar de tamaño ni montarse en un sandbox en ejecución, y uno mayor que la mitad del disco de un servidor se rechaza. Si el que escribía terminó sin desmontarlo, porque falló o se eliminó estando en pausa, monta el volumen de lectura y escritura una vez, lo que reproduce su journal, antes de cualquier montaje de solo lectura.

Un volumen no agrega velocidad de disco. Los volúmenes de un sandbox comparten con su propio disco la velocidad de disco de su tamaño: 64 MiB/s y 1500 operaciones por segundo por vCPU, es decir, 128 MiB/s y 3000 para un SMALL.

Cuánto cuesta un volumen

Un volumen se factura por su tamaño entero, se use o no, a 0,20 US$ por GiB al mes, contado por segundo. Tu plan limita los GiB que tus volúmenes ocupan en total:

PlanVolúmenes, en total
La prueba gratis10 GiB
20 US$ al mes100 GiB
100 US$ al mes600 GiB
500 US$ al mes3500 GiB
2000 US$ al mes16.000 GiB

Para archivos que pertenecen a un sandbox, su propio disco cuesta menos: un sandbox detenido paga 0,03 US$ por GiB al mes de los datos que guarda, y una plantilla lleva archivos a sandboxes nuevos gratis dentro del espacio para plantillas de tu plan. Un fork copia el propio disco de un sandbox junto con su memoria; un volumen nunca se copia.

Cómo se compara

Los volúmenes cuestan más en Pethost que en los proveedores que leímos el 21 de noviembre de 2026. Modal cobraba 0,09 US$ por GiB al mes, Blaxel 0,12 US$ por GB, y Daytona incluía volúmenes gratis, hasta 100 por organización; los volúmenes de E2B estaban en beta privada. Usa un volumen donde varios sandboxes leen los mismos datos, o donde los datos deben sobrevivir al sandbox que los creó; guarda lo demás en el propio disco de un sandbox.

Leer la documentación

Preguntas

¿Un volumen de sandbox tiene backup?

No. Vive en el disco de un servidor y no se copia. Guarda en otro lugar una copia de lo que no puedas perder. El propio disco de un sandbox detenido sí se copia al almacenamiento de objetos.

¿Pueden dos sandboxes escribir en un volumen?

No a la vez. Un sandbox lo monta de lectura y escritura, o cualquier número lo montan de solo lectura, y un sandbox conserva su montaje hasta que se elimina.

¿Puedo montar un volumen en un sandbox en ejecución?

Aún no. Los montajes se fijan al crear un sandbox, hasta 4.

¿Cuánto cuesta un volumen?

0,20 US$ por GiB al mes de su tamaño entero, se use o no, contado por segundo.

Relacionado

Dale a tu agente una VM en 0,15 s

Empezar la prueba gratis