Как устроены тома песочниц
Том — это диск от 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.txtvol=$(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 были в закрытой бете. Берите том там, где несколько песочниц читают одни и те же данные или где данные должны пережить создавшую их песочницу; остальное держите на собственном диске песочницы.