Português
Começar

Agent Sandboxes Volumes que sobrevivem aos sandboxes

Volumes: um disco que sobrevive aos sandboxes

Alguns dados devem durar mais que um sandbox, ou ser lidos por muitos: um dataset, um cache de pacotes, os pesos de um modelo. Um volume os guarda: um disco fora de todo sandbox, montado em um caminho quando um sandbox é criado, e mantido quando o sandbox é excluído.

Como funcionam os volumes de sandbox

Um volume é um disco de 1 a 1.000 GiB em um dos nossos servidores, uma imagem ext4 esparsa fora de todo sandbox. Você cria um com create_volume e o monta ao criar um sandbox, em um caminho absoluto como /data. Um sandbox monta até 4 volumes e roda no servidor que os guarda.

Um sandbox monta um volume para leitura e escrita, ou qualquer número de sandboxes o monta só para leitura, nunca as duas coisas ao mesmo tempo. Um sandbox mantém a montagem até ser excluído: pausá-lo ou pará-lo mantém a montagem. Então, para passar um volume do sandbox que o encheu para os leitores, exclua o que escreve e depois crie os leitores com montagens só leitura. Um fork de um sandbox que monta volumes só para leitura também os monta.

Quando um sandbox é excluído, o volume fica com os arquivos, e o próximo sandbox que o montar os encontra como foram deixados. Cada volume informa os bytes que usa e os sandboxes que o montam, e excluí-lo é recusado enquanto um sandbox o monta. O guia de volumes tem todas as chamadas e campos.

from pethost.sandboxes import Mount, Sandboxes

sandboxes = Sandboxes()  # lê o 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)  # o volume fica

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                 # o volume fica
pethost sandbox new --mount "$vol:/data:ro"  # um leitor

O que saber antes de depender de um volume

Um volume vive no disco de um servidor e não é copiado para nenhum outro lugar. Se esse servidor se perder, o volume se perde com ele, e os sandboxes que o montavam também o perdem. Guarde em outro lugar uma cópia de tudo o que você não pode perder. Já o disco próprio de um sandbox é copiado para o armazenamento de objetos um minuto depois que o sandbox para.

Um volume também prende os sandboxes ao servidor dele. Um sandbox parado que monta um só inicia de novo ali, enquanto um sandbox sem volumes pode iniciar em outro servidor com espaço. Um fork é recusado enquanto o sandbox monta um volume para leitura e escrita. Um volume ainda não pode ser redimensionado nem montado em um sandbox rodando, e um maior que metade do disco de um servidor é recusado. Se o sandbox que escrevia terminou sem desmontá-lo, porque travou ou foi excluído enquanto pausado, monte o volume para leitura e escrita uma vez, o que reproduz o journal dele, antes de qualquer montagem só leitura.

Um volume não acrescenta velocidade de disco. Os volumes de um sandbox dividem a taxa de disco do tamanho dele com o próprio disco: 64 MiB/s e 1.500 operações por segundo por vCPU, ou seja, 128 MiB/s e 3.000 para um SMALL.

Quanto custa um volume

Um volume é cobrado pelo tamanho inteiro, usado ou não, a US$ 0,20 por GiB ao mês, contado por segundo. Seu plano limita os GiB que os seus volumes guardam juntos:

PlanoVolumes, todos juntos
O teste grátis10 GiB
US$ 20 por mês100 GiB
US$ 100 por mês600 GiB
US$ 500 por mês3.500 GiB
US$ 2.000 por mês16.000 GiB

Para arquivos que pertencem a um sandbox, o disco próprio dele custa menos: um sandbox parado paga US$ 0,03 por GiB ao mês dos dados que guarda, e um template leva arquivos para novos sandboxes sem custo, dentro do espaço de templates do seu plano. Um fork copia o disco próprio de um sandbox junto com a memória; um volume nunca é copiado.

Como se compara

Volumes custam mais no Pethost do que nos fornecedores que lemos em 21 de novembro de 2026. O Modal cobrava US$ 0,09 por GiB ao mês, o Blaxel US$ 0,12 por GB, e o Daytona incluía volumes sem custo, até 100 por organização; os volumes do E2B estavam em beta privado. Use um volume onde vários sandboxes leem os mesmos dados, ou onde os dados precisam durar mais que o sandbox que os criou; mantenha o resto no disco próprio de um sandbox.

Ler a documentação

Perguntas

Um volume de sandbox tem backup?

Não. Ele vive no disco de um servidor e não é copiado. Guarde em outro lugar uma cópia do que você não pode perder. O disco próprio de um sandbox parado é copiado para o armazenamento de objetos.

Dois sandboxes podem escrever em um volume?

Não ao mesmo tempo. Um sandbox o monta para leitura e escrita, ou qualquer número o monta só para leitura, e um sandbox mantém a montagem até ser excluído.

Dá para montar um volume em um sandbox rodando?

Ainda não. As montagens são definidas quando um sandbox é criado, até 4 delas.

Quanto custa um volume?

US$ 0,20 por GiB ao mês do tamanho inteiro, usado ou não, contado por segundo.

Relacionados

Dê um computador ao seu agente em 0,15 s

Começar o teste grátis