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

Agent Sandboxes Сама встает на паузу в простое

Простаивающие песочницы сами встают на паузу и останавливаются

Код, который убирает за агентом, писать не нужно. Три таймера у каждой песочницы решают, чем станет простаивающая: пауза через 5 минут, остановка через 30, удаление — никогда. Каждый задается для каждой песочницы отдельно, а 0 его выключает.

Что считается простоем

Песочница простаивает, пока в ней ничего не происходит: нет вызовов к ней и открытых потоков, нет открытых ссылок, SSH-сессий и запросов к ее портам, не идет ход агента и не работает команда, запущенная с keep_awake. Фоновый процесс сам по себе не дает ей уснуть: когда песочница встает на паузу, процесс замораживается вместе с ней и продолжает работу после пробуждения. Каждый сервер проверяет все свои песочницы раз в секунду.

Три таймера: автопауза, автоостановка, автоудаление

  • pause_after_idle_seconds, по умолчанию 300: работающая песочница встает на паузу, ее память и процессы сохраняются, за 30% цены работы.
  • stop_after_idle_seconds, по умолчанию 1800: работающая песочница или песочница на паузе останавливается; ее процессы завершаются, а диск уходит в объектное хранилище по 0,03 $ в месяц за GiB ее собственных данных.
  • delete_after_idle_seconds, по умолчанию 0, то есть никогда: песочница удаляется в любом состоянии.

Все три считают по одним часам — времени с тех пор, как в песочнице что-то происходило в последний раз. Если таймер остановки не позже таймера паузы, работающая песочница останавливается, не вставая сначала на паузу. get_sandbox сообщает, что и когда сделает жизненный цикл дальше, в полях next_state и next_state_time. Таймеры задаются при создании песочницы, меняются потом через update_sandbox, а шаблон может передавать их каждой песочнице, созданной из него.

from pethost.sandboxes import Lifecycle, Sandboxes, SandboxSettings

sandboxes = Sandboxes()  # читает PETHOST_TOKEN
lifecycle = Lifecycle(
    pause_after_idle_seconds=60,  # пауза после минуты простоя
    stop_after_idle_seconds=3600,  # остановка после часа простоя
    delete_after_idle_seconds=7 * 86400,  # удаление после недели простоя
)
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(lifecycle=lifecycle))

# Работа, к которой никто не обращается, пока она идет: keep_awake откладывает паузу, но не дольше часа.
install = "python3 -m venv env && env/bin/pip install pandas scikit-learn"
sandboxes.run_command(sandbox.sandbox_id, command=install, keep_awake=True, timeout_seconds=3600, wait_seconds=0)
id=$(pethost sandbox new --pause-after 1m --stop-after 1h --delete-after 168h)
pethost sandbox run "$id" --keep-awake --timeout 1h -d -- 'python3 -m venv env && env/bin/pip install pandas scikit-learn'

Когда серверу не хватает ресурсов

Сервер может поставить песочницы на паузу или остановить их раньше их таймеров. Когда ему не хватает памяти, он ставит на паузу работающие песочницы, которые простаивают минуту и дольше; когда не хватает диска, он останавливает песочницы на паузе, которые простаивают дольше всех. Ничего не теряется: песочница на паузе просыпается как любая другая, остановленная снова запускается со своего диска, а state_message объясняет, почему так вышло.

Как разбудить остановленную песочницу

По умолчанию вызов к остановленной песочнице отклоняется (FAILED_PRECONDITION с Stopped), а запрос к ее порту получает ответ 503, пока ее не запустит resume_sandbox. Если включен wake_when_stopped, остановленная песочница просыпается от вызова, входа по SSH или запроса к порту, как песочница на паузе: примерно за 0,2 с или примерно за 10 с на GiB, если диск приходится забирать из объектного хранилища. Ее vCPU тогда засчитываются в ваш тариф, даже пока она остановлена. Это подходит песочнице, которую время от времени вызывает вебхук.

Сколько стоит простой

Максимального срока жизни у песочниц нет: та, которой не дают уснуть, работает, пока вы ее не остановите, а оставленная в покое с каждым шагом стоит меньше. Возьмем одну песочницу SMALL, в которой агент работает 2 часа в день, а остальные 22 она простаивает, и месяц из 30 дней. Если в простое она на паузе, использование стоит 4,64 $: 60 часов по 0,018 $ и 660 по 0,0054 $. Если бы она все время работала, вышло бы 12,96 $. Если в простое она остановлена и хранит 5 GiB собственных данных, она стоит 1,22 $, но каждый запуск тогда загружает ее с диска, без прежних процессов. Как считается каждая из этих секунд, описано на странице о посекундной оплате.

Сравнение с другими

Другие провайдеры ограничивают срок жизни песочницы. По их страницам на 21 ноября 2026 года сессии E2B длятся до 1 часа на Hobby и до 24 часов на Pro, а пауза начинает отсчет заново; песочницы Modal живут по умолчанию 5 минут, а максимум 24 часа; сессии Vercel Sandbox длятся 45 минут на Hobby и 24 часа на Pro. Pethost такого ограничения не ставит: песочница встает на паузу и останавливается по своим таймерам и живет, пока ее не удалите вы или заданный вами таймер удаления.

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

Вопросы

Встанет ли долгая сборка на паузу на полпути?

Нет, если запустить ее с keep_awake: пока эта команда работает, песочница не уходит на паузу из-за простоя. Задайте еще и timeout_seconds, чтобы зависшая команда не держала ее без сна вечно.

Можно ли сделать так, чтобы песочница никогда не вставала на паузу?

Да: задайте pause_after_idle_seconds равным 0. Тогда она работает, и оплачивается как работающая, пока не сработает таймер остановки или пока вы сами ее не остановите.

Что будит остановленную песочницу?

resume_sandbox, а при включенном wake_when_stopped — любой вызов к ней, вход по SSH или запрос к одному из ее портов.

Удаляют ли что-нибудь автопауза и автоостановка?

Нет. Пауза сохраняет память, процессы и диск, остановка — диск, а удаляется что-то, только если вы зададите delete_after_idle_seconds.

Есть ли максимальный срок жизни?

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

По теме

Дайте агенту компьютер за 0,15 с

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