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

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 пока нет: установите все в песочнице и сохраните ее, как выше. Шаблон переносит файлы, но никогда не работающие процессы. Чтобы скопировать песочницу вместе с памятью и процессами — с работающим dev-сервером или агентом на середине задачи, — сделайте форк. Каждая песочница, из шаблона или нет, — отдельная микроВМ 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 с

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