Перейти к основному содержимому
Открыть Markdown

Создание песочницы

Создайте песочницу из шаблона. Минимальному запросу нужно только имя шаблона: ресурсы берутся из настроек шаблона и инсталляции, а песочница, созданная без собственного имени, получает читаемое — например, brave-otter-d805. Новые песочницы через REST и веб-интерфейс личные для автора внутри организации. Передайте "visibility": "org" в REST-запросе, если доступ нужен другим участникам. Старые песочницы остаются общими; созданные через E2B — личные. URL превью — отдельная ссылка доступа; личная видимость ее не отзывает.

Перед началом​

Нужны право создания в активном аккаунте и доступный шаблон. REST-клиенту потребуется персональный токен с правами Полные.

Решите, будет ли песочница одноразовой. Дайте ей понятное имя и не передавайте учетные данные напрямую, если подходит переиспользуемый секрет.

Создание через веб-интерфейс​

  1. Откройте Песочницы → Новая песочница и выберите карточку каталога.
  2. Задайте Имя песочницы или оставьте поле пустым — имя будет сгенерировано. В организации выберите видимость Личный или Для организации.
  3. Если в форме есть блок Нужно для запуска, заполните обязательные поля. Для секрета выберите сохраненный секрет типа Окружение с этой переменной или введите новое значение и нажмите Сохранить ключ: форма сохранит его как новый секрет типа Окружение и подключит к этой песочнице.
  4. Проверьте сводку: vCPU, RAM, диск и поведение автопаузы.
  5. Раскрывайте Дополнительные настройки, только если нужно сменить шаблон или его версию, vCPU, память, диск, доступ к хранилищу, пробуждение по запросу, автопаузу, переменные, Секреты, MCP-серверы, Навыки или Внешний доступ к песочнице.
  6. Нажмите Создать песочницу.

Веб-интерфейс откроет страницу новой песочницы.

Создание через 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 только при необходимости.
  • Удаление одноразовой песочницы отличается от остановки: остановка сохраняет ресурс.