Русский
Начать

Agent Sandboxes Тома, которые переживают песочницы

Тома: диск, который переживает свои песочницы

Некоторые данные должны пережить песочницу или читаться многими: датасет, кеш пакетов, веса модели. Для них есть том: диск вне всех песочниц, который подключается по пути при создании песочницы и остается, когда песочницу удаляют.

Как устроены тома песочниц

Том — это диск от 1 до 1 000 GiB на одном из наших серверов, разреженный образ ext4 вне всех песочниц. Том создается через create_volume и подключается при создании песочницы по абсолютному пути, например /data. Песочница подключает до 4 томов и работает на сервере, где они лежат.

Том подключает на запись одна песочница или на чтение сколько угодно песочниц, но никогда то и другое сразу. Песочница держит подключение, пока ее не удалят: пауза и остановка его сохраняют. Поэтому, чтобы передать том от песочницы, которая его заполнила, читающим, удалите пишущую и создайте читающие с подключением только для чтения. Форк песочницы, которая подключает тома только для чтения, тоже их подключает.

Когда песочницу удаляют, том остается вместе с файлами, и следующая песочница, которая его подключит, найдет их в том виде, в каком их оставили. Каждый том сообщает, сколько байтов занимает и какие песочницы его подключают, а удалить его нельзя, пока его подключает хоть одна песочница. Все вызовы и поля описаны в руководстве по томам.

from pethost.sandboxes import Mount, Sandboxes

sandboxes = Sandboxes()  # читает 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)  # том остается

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                 # том остается
pethost sandbox new --mount "$vol:/data:ro"  # читающая

Что знать, прежде чем полагаться на том

Том лежит на диске одного сервера и никуда больше не копируется. Если этот сервер потерян, том теряется вместе с ним, и песочницы, которые его подключали, тоже его лишаются. Держите копию того, что нельзя потерять, где-нибудь еще. Собственный диск песочницы, наоборот, копируется в объектное хранилище через минуту после ее остановки.

Том также привязывает свои песочницы к своему серверу. Остановленная песочница, которая подключает том, снова запускается только там, тогда как песочница без томов может запуститься на другом сервере, где есть место. Форк отклоняется, пока песочница подключает том на запись. Изменить размер тома или подключить его к работающей песочнице пока нельзя, а том больше половины диска сервера не принимается. Если пишущая песочница завершилась, не отключив том, потому что упала или была удалена на паузе, один раз подключите том на запись — это воспроизведет его журнал — прежде чем подключать его только для чтения.

Том не добавляет скорости диска. Тома песочницы делят скорость диска ее размера с ее собственным диском: 64 MiB/s и 1 500 операций в секунду на vCPU, то есть 128 MiB/s и 3 000 для SMALL.

Сколько стоит том

Том оплачивается за весь свой размер, занят он или нет, по 0,20 $ за GiB в месяц, посекундно. Ваш тариф ограничивает, сколько GiB все ваши тома занимают вместе:

ТарифТома, всего
Пробный период10 GiB
20 $ в месяц100 GiB
100 $ в месяц600 GiB
500 $ в месяц3 500 GiB
2 000 $ в месяц16 000 GiB

Для файлов, которые принадлежат одной песочнице, ее собственный диск обходится дешевле: остановленная песочница платит 0,03 $ в месяц за GiB своих данных, а шаблон бесплатно переносит файлы в новые песочницы в пределах места для шаблонов по вашему тарифу. Форк копирует собственный диск песочницы вместе с памятью; том не копируется никогда.

Сравнение с другими

Тома в Pethost дороже, чем у провайдеров, которых мы прочли 21 ноября 2026 года. Modal брал 0,09 $ за GiB в месяц, Blaxel — 0,12 $ за GB, а Daytona включал тома бесплатно, до 100 на организацию; тома E2B были в закрытой бете. Берите том там, где несколько песочниц читают одни и те же данные или где данные должны пережить создавшую их песочницу; остальное держите на собственном диске песочницы.

Читать документацию

Вопросы

Делается ли бэкап тома песочницы?

Нет. Том лежит на диске одного сервера и не копируется. Держите копию того, что нельзя потерять, где-нибудь еще. Собственный диск остановленной песочницы копируется в объектное хранилище.

Могут ли две песочницы писать в один том?

Не одновременно. Одна песочница подключает его на запись или сколько угодно — только для чтения, и песочница держит подключение, пока ее не удалят.

Можно ли подключить том к работающей песочнице?

Пока нет. Тома подключаются при создании песочницы, до 4 штук.

Сколько стоит том?

0,20 $ в месяц за GiB его полного размера, занят он или нет, посекундно.

По теме

Дайте агенту компьютер за 0,15 с

Начать пробный период