Українська
Почати

Agent Sandboxes Збережіть пісочницю як шаблон

Шаблони: встановіть один раз і запускайте з них кожну пісочницю

Встановіть те, що потрібно для роботи, один раз, у пісочниці, вручну чи руками агента. Збережіть диск пісочниці як шаблон, і кожна нова пісочниця стартує з усім цим на місці: пакетами, файлами, образами Docker.

Наш шаблон: base

Кожна пісочниця стартує із шаблону. Наш — base: Ubuntu 24.04 з build-essential, git, curl, wget, ripgrep і jq; Python 3 з pip і venv; Node.js 22; Claude Code, Codex і OpenCode з їхніми SDK; Docker з Compose і Buildx; і робочий стіл 1280×800 із Google Chrome. Ви працюєте як user, із sudo без пароля. Його коренева файлова система доступна лише для читання й читається просто з диска сервера, тож те, чого пісочниця не запускає, не коштує їй пам’яті, а ні робочий стіл, ні Docker не запускаються, доки щось їх не попросить.

Кожна версія base названа за sha256 свого вмісту: операційної системи, її пакетів і гостьового ядра. Ми збираємо нову щомісяця, а для виправлення безпеки Chrome, ядра чи пакетів — одразу. Нові пісочниці стартують із найновішої; пісочниця й шаблон, збережений із неї, зберігають базу, з якої пісочниця стартувала.

Власні шаблони, збережені з пісочниці

Власний шаблон — це диск пісочниці, збережений поверх нашої бази. Налаштуйте пісочницю вручну чи руками агента, і create_template збереже її диск як наступну версію назви: my-app@1, потім my-app@2. Зберігаються лише файли: ні пам’яті, ні запущених процесів, ні історії команд пісочниці чи розмов агентів — нові пісочниці починають без них.

Виклик відповідає за 28–49 ms із версією в стані SAVING. Пісочниця, що працює, працює далі, зупиняючись на кілька мілісекунд, поки знімається її диск. Потім сервер перевіряє файлову систему й зменшує її до розміру вмісту в окремій допоміжній ВМ і завантажує в об’єктне сховище лише ваші власні фрагменти, стиснені й зашифровані ключем лише для цієї версії. Версія невеликої пісочниці стає READY через 0,9–1,5 с після виклику; загалом це займає близько 5 с плюс 10 с на кожен GiB ваших власних даних. Версія в стані READY вказує свій min_size, найменший розмір, чий диск уміщує те, що вона зберегла.

Запуск пісочниць із шаблону

Назвіть шаблон під час створення пісочниці: my-app бере його найновішу версію в стані READY, my-app@3 — саме цю. Будь-який сервер запускає пісочниці з будь-якої версії. Панель спершу звертається до серверів, які вже мають цю версію, і там створення займає 218–225 ms. Сервер, у якого її немає, стягує її один раз, приблизно 10 с на кожен GiB версії, і зберігає для наступних. Пісочниця із шаблону може мати будь-який розмір, починаючи з min_size версії.

Образи Docker лежать на диску пісочниці, тож шаблон їх переносить: пісочниця, створена з нього, виконує docker run з образом, якого ніколи не стягувала. (Час тут виміряно через панель на відстані 16 ms від сервера.)

import time

from pethost.sandboxes import Sandboxes

sandboxes = Sandboxes()  # читає PETHOST_TOKEN
sandbox = sandboxes.create_sandbox()  # з base
sandboxes.run_command(
    sandbox.sandbox_id,
    command="python3 -m venv ~/venv && ~/venv/bin/pip install pandas && docker pull postgres:18",
)

version = sandboxes.create_template("my-app", sandbox_id=sandbox.sandbox_id)
name = f"my-app@{version.version}"
while sandboxes.get_template(name).state.name == "SAVING":
    time.sleep(1)

copy = sandboxes.create_sandbox(name)  # pandas і образ postgres уже на місці
print(sandboxes.run_command(copy.sandbox_id, command="docker images postgres").stdout)
pethost sandbox template save api-dev my-app   # її диск як наступна версія my-app
pethost sandbox template show my-app           # SAVING, потім READY
pethost sandbox new --template my-app          # нова пісочниця з найновішої версії

Версії, місце й ціна

Назва вміщує до 10 версій. Робочий простір зберігає одну версію за раз, а всі його версії разом мають уміститися в місце для шаблонів його тарифу, яке рахується за тим, скільки вони займають в об’єктному сховищі, стиснені:

ТарифМісце для шаблонів
20 $ на місяць5 GiB
100 $ на місяць30 GiB
500 $ на місяць175 GiB
2 000 $ на місяць800 GiB

Шаблони нічого не коштують понад це місце. Видалення шаблону, тобто всіх версій його назви, одразу звільняє місце, а пісочниці, створені з нього, далі працюють, стають на паузу, зупиняються й продовжуються: об’єктне сховище зберігає версію, доки не видалено останню з них.

Чого шаблони поки не вміють

Збирання з Dockerfile поки немає: встановіть усе в пісочниці й збережіть її, як описано вище. Шаблон переносить файли, але ніколи не запущені процеси. Щоб скопіювати пісочницю з пам’яттю й процесами, із запущеним сервером розробки чи агентом на півдорозі до розв’язання завдання, скопіюйте її. Кожна пісочниця, із шаблону чи ні, — окрема microVM Firecracker із власним ядром. Посібник із шаблонів описує кожен виклик і поле.

Порівняння з іншими

21 листопада 2026 року E2B збирав шаблони своїм конструктором шаблонів, а Daytona створювала знімки з образу або Dockerfile, чого Pethost поки не вміє. boat.dev зберігає знімки й бере 0,056 $ за знімок на день понад ті, що включені в тариф. Шаблон Pethost нічого не коштує в межах місця вашого тарифу.

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

Запитання

Чи можна зібрати шаблон пісочниці з Dockerfile?

Поки ні. Запустіть пісочницю з base, виконайте в ній кроки вашого Dockerfile як команди й збережіть її. Також можна запустити docker build усередині пісочниці: образ, який він збере, лежить на диску пісочниці, і шаблон його перенесе.

Скільки коштує шаблон?

Нічого. Його версії зараховуються в місце для шаблонів вашого тарифу, 5 GiB на тарифі за 20 $, і вимірюються так, як зберігаються, — стиснені.

Чи зберігає шаблон запущені процеси?

Ні, він зберігає файли. Копіювання переносить пісочницю з пам’яттю й запущеними процесами.

Як швидко пісочниця стартує із шаблону?

За 218–225 ms на сервері, який має цю версію. Перший запуск на сервері, у якого її немає, спершу її стягує, приблизно 10 с на кожен GiB.

Дивіться також

Дайте агентові комп’ютер за 0,15 с

Почати пробний період