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

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

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

  • Скачайте: скрипт запуска
  • Вам понадобится: Bash, cURL и jq локально, шаблон base на Just 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-аргументом в оболочку внутри песочницы; управляющий персональный токен остается на вашей машине. Скрипт запуска печатает вывод команды, ее код возврата и строку об удалении песочницы.

Что получится​

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

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

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

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

Как адаптировать​

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

Удаление ресурсов​

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

Дальше: поручите агенту исправить баг в песочнице.