# Изолированный запуск команды оболочки

Запускать чужую команду оболочки на своем ноутбуке рискованно. Отдайте ее отдельной Linux-машине: посмотрите вывод и код возврата, а скрипт запуска попытается убрать за собой и после успеха, и после ошибки.

* **Скачайте:** [скрипт запуска](/example-assets/disposable.zip)
* **Вам понадобится:** Bash, cURL и jq локально, шаблон `base` на Just Run.

## Запуск[​](#run "Прямая ссылка на Запуск")

Распакуйте архив `disposable`. На вашем компьютере нужны Bash, cURL и jq. В аккаунте должна быть квота на создание хотя бы одной песочницы и права на шаблон `base`.

Настройка доступа к API (один раз)

Укажите HTTPS-адрес платформы и персональный токен с правами *Полные*:

```
export JUSTRUN_API="https://your-just-run-host"
read -rsp 'just-run PAT: ' JUSTRUN_PAT; printf '\n'
export JUSTRUN_PAT
```

```
cd disposable
PROGRAM='uname -a; printf "work complete\n"' bash run.sh
```

Полный `run.sh` берет на себя ключ идемпотентности при создании, ожидание готовности, результат команды и удаление. Вам не нужно вставлять эту обвязку в свое приложение, чтобы разобрать пример. Команда передается JSON-аргументом в оболочку **внутри песочницы**; управляющий персональный токен остается на вашей машине. Скрипт запуска печатает вывод команды, ее код возврата и строку об удалении песочницы.

## Что получится[​](#result "Прямая ссылка на Что получится")

Ожидайте `exit_code: 0`, информацию о Linux, `work complete` и `Sandbox deleted: <id>`. Эти четыре строки показывают, что команда выполнилась в отдельной Linux-машине, а скрипт запуска убрал машину за собой.

Теперь проверьте сценарий ошибки:

```
PROGRAM='printf "intentional failure\n" >&2; exit 7' bash run.sh
```

Этот запуск должен завершиться локальной ошибкой и все равно попытаться удалить ресурс. Так вы увидите обе стороны примера: успешный прогон и неудачный код возврата.

## Как адаптировать[​](#customise "Прямая ссылка на Как адаптировать")

Передайте в `PROGRAM` программу для оболочки, которую хотите проверить. Изоляция не делает ее заслуживающей доверия: подключайте только необходимые сети и данные. Перед выполнением враждебного кода изучите [безопасность песочниц](/sandboxes/security).

## Удаление ресурсов[​](#cleanup "Прямая ссылка на Удаление ресурсов")

Успешный запуск удаляет песочницу автоматически. Ошибка `DELETE` выводит оставшийся ID и не маскируется сообщением об успехе. Если создание прервалось или его исход неизвестен, найдите `disposable-example` в разделе *Песочницы* и определите ресурс своего запуска. Удалите оставшиеся ресурсы и сбросьте `JUSTRUN_PAT` после завершения.

**Дальше:** [поручите агенту исправить баг в песочнице](/examples/build-a-coding-agent.md).
