Документация Agent Sandboxes · Задачи
Тома: диск, который переживает песочницы
Том — это диск вне всех песочниц, который подключается к песочнице по пути: датасет, который читают многие песочницы, кеш, который переживает каждую задачу, файлы, которые должны остаться после удаления песочницы. Он лежит на диске одного сервера, и это нужно знать, прежде чем что-то на него класть.
CreateVolumeсоздает том от 1 до 1 000 GiB;CreateSandboxподключает до 4 томов при создании, каждый по своему пути.- На запись — одна песочница за раз, на чтение — сколько угодно.
- На одном сервере, без копий: песочница, которая его подключает, работает там же, и если сервер потерян, потерян и том.
- Оплачивается весь размер, 0,20 $ за GiB в месяц, занят он или нет.
Step 1: Создайте том
Том создается пустым, на сервере, где есть место, и его корень принадлежит user.
volume = sandboxes.create_volume("data", size_gib=10)
print(volume.volume_id, volume.size_gib) # ziwv1r8ean3dd9sk 10
const volume = await sandboxes.createVolume({ name: "data", sizeGib: 10 });
console.log(volume.volumeId, volume.sizeGib);
volume, err := client.CreateVolume(ctx, &sandboxes.CreateVolumeRequest{Name: "data", SizeGib: 10})
if err != nil {
log.Fatal(err)
}
fmt.Println(volume.VolumeID, volume.SizeGib)
let volume = sandboxes
.create_volume(CreateVolumeRequest { name: "data".into(), size_gib: 10, ..Default::default() })
.await?;
println!("{} {}", volume.volume_id, volume.size_gib);
$ pethost sandbox volume new data --size 10
✓ Made the volume data, 10 GiB. Mount it: pethost sandbox new --mount o2rvhgm1dxaefoj7:/data
o2rvhgm1dxaefoj7
Step 2: Подключите его к песочнице
Подключения задаются при создании, каждое — том и абсолютный путь. Песочница работает на сервере тома.
from pethost.sandboxes import Mount
writer = sandboxes.create_sandbox("base", mounts=[Mount(volume_id=volume.volume_id, path="/data")])
sandboxes.run_command(writer.sandbox_id, command="date > /data/first-run.txt")
const writer = await sandboxes.createSandbox({
template: "base",
mounts: [{ volumeId: volume.volumeId, path: "/data" }],
});
await sandboxes.runCommand({ sandboxId: writer.sandboxId, command: "date > /data/first-run.txt" });
writer, err := client.CreateSandbox(ctx, &sandboxes.CreateSandboxRequest{
Template: "base",
Mounts: []sandboxes.Mount{{VolumeID: volume.VolumeID, Path: "/data"}},
})
if err != nil {
log.Fatal(err)
}
_, err = client.RunCommand(ctx, &sandboxes.RunCommandRequest{SandboxID: writer.SandboxID, Command: "date > /data/first-run.txt"})
let mount = Mount { volume_id: volume.volume_id.clone(), path: "/data".into(), ..Default::default() };
let writer = sandboxes
.create_sandbox(CreateSandboxRequest { template: "base".into(), mounts: vec![mount], ..Default::default() })
.await?;
sandboxes
.run_command(RunCommandRequest {
sandbox_id: writer.sandbox_id.clone(),
command: "date > /data/first-run.txt".into(),
..Default::default()
})
.await?;
$ pethost sandbox new --name writer --mount o2rvhgm1dxaefoj7:/data
✓ Made sandbox writer (upc3ehxd65rjgz32): default, running, from base@17, in <1 s
upc3ehxd65rjgz32
Next: pethost sandbox run upc3ehxd65rjgz32 -- <command> · pethost sandbox shell upc3ehxd65rjgz32
$ pethost sandbox run writer -- 'date > /data/first-run.txt'
CreateSandbox {"name": "writer", "mounts": [{"volume_id": "…", "path": "/data"}]}
Step 3: Откройте его на чтение другим и удалите, когда закончите
Когда ни одна песочница не подключает его на запись, на чтение его может подключить сколько угодно песочниц. Том остается, когда удаляются подключавшие его песочницы, и уходит только через DeleteVolume, который получает отказ, пока том подключен к какой-либо песочнице.
sandboxes.delete_sandbox(writer.sandbox_id)
reader = sandboxes.create_sandbox("base", mounts=[Mount(volume_id=volume.volume_id, path="/data", read_only=True)])
print(sandboxes.run_command(reader.sandbox_id, command="cat /data/first-run.txt").stdout) # Sun Nov 22 00:25:33 UTC 2026
sandboxes.delete_sandbox(reader.sandbox_id)
sandboxes.delete_volume(volume.volume_id)
await sandboxes.deleteSandbox({ sandboxId: writer.sandboxId });
const reader = await sandboxes.createSandbox({
template: "base",
mounts: [{ volumeId: volume.volumeId, path: "/data", readOnly: true }],
});
console.log((await sandboxes.runCommand({ sandboxId: reader.sandboxId, command: "cat /data/first-run.txt" })).stdout);
await sandboxes.deleteSandbox({ sandboxId: reader.sandboxId });
await sandboxes.deleteVolume({ volumeId: volume.volumeId });
if _, err := client.DeleteSandbox(ctx, &sandboxes.DeleteSandboxRequest{SandboxID: writer.SandboxID}); err != nil {
log.Fatal(err)
}
reader, err := client.CreateSandbox(ctx, &sandboxes.CreateSandboxRequest{
Template: "base",
Mounts: []sandboxes.Mount{{VolumeID: volume.VolumeID, Path: "/data", ReadOnly: true}},
})
if err != nil {
log.Fatal(err)
}
read, err := client.RunCommand(ctx, &sandboxes.RunCommandRequest{SandboxID: reader.SandboxID, Command: "cat /data/first-run.txt"})
if err != nil {
log.Fatal(err)
}
fmt.Print(read.Stdout)
_, err = client.DeleteSandbox(ctx, &sandboxes.DeleteSandboxRequest{SandboxID: reader.SandboxID})
if err == nil {
_, err = client.DeleteVolume(ctx, &sandboxes.DeleteVolumeRequest{VolumeID: volume.VolumeID})
}
sandboxes
.delete_sandbox(DeleteSandboxRequest { sandbox_id: writer.sandbox_id.clone(), ..Default::default() })
.await?;
let mount = Mount { volume_id: volume.volume_id.clone(), path: "/data".into(), read_only: true };
let reader = sandboxes
.create_sandbox(CreateSandboxRequest { template: "base".into(), mounts: vec![mount], ..Default::default() })
.await?;
let read = sandboxes
.run_command(RunCommandRequest {
sandbox_id: reader.sandbox_id.clone(),
command: "cat /data/first-run.txt".into(),
..Default::default()
})
.await?;
print!("{}", read.stdout);
sandboxes
.delete_sandbox(DeleteSandboxRequest { sandbox_id: reader.sandbox_id.clone(), ..Default::default() })
.await?;
sandboxes
.delete_volume(DeleteVolumeRequest { volume_id: volume.volume_id.clone(), ..Default::default() })
.await?;
$ pethost sandbox rm writer --yes
upc3ehxd65rjgz32 deleted
$ pethost sandbox new --name reader --mount o2rvhgm1dxaefoj7:/data:ro
✓ Made sandbox reader (zc44605gliwn2v1b): default, running, from base@17, in <1 s
zc44605gliwn2v1b
Next: pethost sandbox run zc44605gliwn2v1b -- <command> · pethost sandbox shell zc44605gliwn2v1b
$ pethost sandbox run reader -- cat /data/first-run.txt
Sun Nov 22 00:25:40 UTC 2026
$ pethost sandbox rm reader --yes
zc44605gliwn2v1b deleted
$ pethost sandbox volume rm o2rvhgm1dxaefoj7 --yes
o2rvhgm1dxaefoj7
Где хранится том
Том — это файл на диске одного сервера песочниц с файловой системой ext4, и песочница, которая его подключает, работает на этом сервере. Он не копируется ни в объектное хранилище, ни на другой сервер. Из этого следуют три вещи:
- Если его сервер потерян, том потерян: он становится DELETED, и песочницы, которые его подключали, его теряют. Не храните там единственную копию чего-либо: то, что важно, отправляйте еще и в свое хранилище.
- Песочница с томом остается на его сервере. Остановленная песочница без томов может запуститься на другом сервере, когда ее собственный заполнен; песочница с томом ждет места на своем и пока получает отказ с
NoCapacity. - Песочницу с томом на запись нельзя скопировать форком: в том пишет только одна песочница за раз.
Том делит скорость диска с песочницей, которая его подключает, — 64 MiB/s на vCPU. Том больше половины диска сервера получает отказ.
Тома и собственный диск песочницы
Большинству задач том не нужен. Собственный диск песочницы переживает ее паузы и остановки: диск остановленной песочницы хранится в объектном хранилище и возвращается, когда она возобновляется, на любом сервере. Шаблон переносит файлы в каждую новую песочницу. Том — для данных, которые переживают использующие их песочницы или которые читают многие сразу: датасет, веса модели, общий кеш.
Сколько он стоит
Том оплачивается за весь свой размер, 0,20 $ за GiB в месяц, посекундно, от создания до удаления, подключен он к песочнице или нет. Ваш тариф ограничивает, сколько занимают все тома рабочего пространства вместе: 100 GiB на тарифе за 20 $, 600 GiB на тарифе за 100 $, 10 GiB в пробном периоде. Workspace.volume_gib_used говорит, сколько они занимают сейчас.
Если не работает
FAILED_PRECONDITION: том подключен к другой песочнице: он подключен на запись. Подключите его только для чтения или удалите либо остановите песочницу, которая в него пишет.FAILED_PRECONDITION: возможно, нужно воспроизвести его журнал: последняя песочница, которая в него писала, завершилась, не отключив его. Подключите его один раз на запись, затем снова только для чтения.FAILED_PRECONDITIONнаDeleteVolume: том подключен к песочнице. Сначала удалите ее.RESOURCE_EXHAUSTEDсLimitReached,volume_gib: тома рабочего пространства превысили бы GiB тарифа. Удалите один или сделайте его меньше.UNAVAILABLEсNoCapacityпри создании или возобновлении: на сервере тома сейчас нет места, а песочница с томом не может переехать. Попробуйте позже.
Вопросы
Есть ли у тома бэкап?
Нет. Он лежит на диске одного сервера и никуда не копируется: храните копию важного где-то еще.
Могут ли несколько песочниц делить один том?
На чтение — сколько угодно одновременно. На запись — по одной за раз.
Можно ли подключить том к работающей песочнице?
Нет: подключения задаются при создании, до 4 на песочницу.
Оплачивается ли том, пока его никто не подключает?
Да, за весь размер, 0,20 $ за GiB в месяц, пока вы его не удалите.
Нужен ли том, чтобы сохранять файлы между сессиями?
Нет. Собственный диск песочницы переживает паузы и остановки; том — для данных, которые переживают саму песочницу.
Попробуйте Pethost Agent Sandboxes
Пробный период на 7 дней: 1 $ использования и 4 vCPU, нужна карта. Затем тариф от 20 $ в месяц, в который входит столько же использования.