Создание песочницы
Создайте песочницу из шаблона. Минимальному запросу нужно только имя шаблона:
ресурсы берутся из настроек шаблона и инсталляции, а песочница, созданная без
собственного имени, получает читаемое — например, brave-otter-d805.
Новые песочницы через REST и веб-интерфейс личные для автора внутри организации.
Передайте "visibility": "org" в REST-запросе, если доступ нужен другим
участникам. Старые песочницы остаются общими; созданные через E2B — личные. URL превью
— отдельная ссылка доступа; личная видимость ее не отзывает.
Перед началом
Нужны право создания в активном аккаунте и доступный шаблон. REST-клиенту потребуется персональный токен с правами Полные.
Решите, будет ли песочница одноразовой. Дайте ей понятное имя и не передавайте учетные данные напрямую, если подходит переиспользуемый секрет.
Создание через веб-интерфейс
- Откройте Песочницы → Новая песочница и выберите карточку каталога.
- Задайте Имя песочницы или оставьте поле пустым — имя будет сгенерировано. В организации выберите видимость Личный или Для организации.
- Если в форме есть блок Нужно для запуска, заполните обязательные поля. Для секрета выберите сохраненный секрет типа Окружение с этой переменной или введите новое значение и нажмите Сохранить ключ: форма сохранит его как новый секрет типа Окружение и подключит к этой песочнице.
- Проверьте сводку: vCPU, RAM, диск и поведение автопаузы.
- Раскрывайте Дополнительные настройки, только если нужно сменить шаблон или его версию, vCPU, память, диск, доступ к хранилищу, пробуждение по запросу, автопаузу, переменные, Секреты, MCP-серверы, Навыки или Внешний доступ к песочнице.
- Нажмите Создать песочницу.
Веб-интерфейс откроет страницу новой песочницы.
Создание через REST API
curl --fail-with-body --silent --show-error \
--request POST "$JUSTRUN_API/v1/sandboxes" \
--header "Authorization: Bearer $JUSTRUN_PAT" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: create-my-worker-1" \
--data '{
"template": "base",
"name": "my-worker",
"vcpu": 1,
"ram_mb": 512
}' |
jq
Поддерживается 1–8 vCPU и 128–8192 МиБ RAM. Корневой диск можно увеличить относительно размера шаблона, но нельзя уменьшить.
Пресет может объявить обязательные поля. Чтобы создать песочницу из конкретного
пресета, передайте его id из GET /v1/presets строкой в preset_id; без
него применяется пресет шаблона по умолчанию. Шлюз проверяет обязательные поля
после слияния env пресета, подключенных секретов и env запроса (env
запроса важнее) и отклоняет отсутствующее или пустое значение, а также
значение вне вариантов поля выбора, с HTTP 422 и нарушением с указателем
/env/<NAME>. VM в этом случае не создается.
Используйте уникальный ключ идемпотентности для одной логической операции. Повторяйте его только при повторе того же запроса создания после неопределенного ответа.
Проверка результата
Создание возвращает HTTP 201, id и status. Текущее состояние можно получить:
curl --fail-with-body --silent --show-error \
"$JUSTRUN_API/v1/sandboxes/$SANDBOX_ID" \
--header "Authorization: Bearer $JUSTRUN_PAT" |
jq '{id, status, template, vcpu, ram_mb, provisioning}'
Дождитесь status: "running". Если есть блок provisioning, также дождитесь
provisioning.status: "ready" перед использованием клонированного репозитория
или другого подготовленного артефакта. failed — терминальное состояние, а шаги
укажут отказавший компонент подготовки.
Для рабочей среды
- Создание расходует квоты песочницы, vCPU, RAM и хранилища активного аккаунта.
Превышение квоты возвращает
429. - Если нет здорового узла с достаточными ресурсами, API возвращает
503. - Unix-пользователь по умолчанию — непривилегированный
user. Запрашивайтеrootтолько при необходимости. - Удаление одноразовой песочницы отличается от остановки: остановка сохраняет ресурс.