Русский
Меню документации

Документация Agent Sandboxes · Задачи

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

Обновлено · 5 мин чтения

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

Коротко
  • CreateVolume создает том от 1 до 1 000 GiB; CreateSandbox подключает до 4 томов при создании, каждый по своему пути.
  • На запись — одна песочница за раз, на чтение — сколько угодно.
  • На одном сервере, без копий: песочница, которая его подключает, работает там же, и если сервер потерян, потерян и том.
  • Оплачивается весь размер, 0,20 $ за GiB в месяц, занят он или нет.

Step 1: Создайте том

Том создается пустым, на сервере, где есть место, и его корень принадлежит user.

Python
volume = sandboxes.create_volume("data", size_gib=10)
print(volume.volume_id, volume.size_gib)  # ziwv1r8ean3dd9sk 10
TypeScript
const volume = await sandboxes.createVolume({ name: "data", sizeGib: 10 });
console.log(volume.volumeId, volume.sizeGib);
Go
volume, err := client.CreateVolume(ctx, &sandboxes.CreateVolumeRequest{Name: "data", SizeGib: 10})
if err != nil {
	log.Fatal(err)
}
fmt.Println(volume.VolumeID, volume.SizeGib)
Rust
let volume = sandboxes
    .create_volume(CreateVolumeRequest { name: "data".into(), size_gib: 10, ..Default::default() })
    .await?;
println!("{} {}", volume.volume_id, volume.size_gib);
CLI
$ pethost sandbox volume new data --size 10
✓ Made the volume data, 10 GiB. Mount it:  pethost sandbox new --mount o2rvhgm1dxaefoj7:/data
o2rvhgm1dxaefoj7

Step 2: Подключите его к песочнице

Подключения задаются при создании, каждое — том и абсолютный путь. Песочница работает на сервере тома.

Python
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")
TypeScript
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" });
Go
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"})
Rust
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?;
CLI
$ 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'
MCP
CreateSandbox {"name": "writer", "mounts": [{"volume_id": "…", "path": "/data"}]}

Step 3: Откройте его на чтение другим и удалите, когда закончите

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

Python
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)
TypeScript
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 });
Go
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})
}
Rust
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?;
CLI
$ 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 $ в месяц, в который входит столько же использования.

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