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

Песочницы

Песочница — вычислительное окружение, созданное из конкретной версии шаблона. У нее есть собственная файловая система, процессы, выделенные ресурсы, переменные, настройки и опубликованные порты. Используйте песочницу для интерактивной разработки, выполнения команд и сервисов с явно управляемым жизненным циклом.

Возможности​

  • Выполнять команды и получать stdout, stderr и код выхода.
  • Стримить вывод или запускать фоновые процессы.
  • Работать через браузерный терминал и файловый проводник.
  • Публиковать порт через URL превью.
  • Останавливать или гибернировать песочницу и возвращаться позже.
  • Сохранять подходящее состояние как новый шаблон.

Жизненный цикл​

Создание → Активна — кратчайший путь. Активная песочница выполняет команды и обслуживает порты.

  • Остановка выключает VM, сохраняя файловую систему. Возобновление запускает ее снова.
  • Гибернация сохраняет состояние VM для последующего пробуждения.
  • Удаление уничтожает ресурс песочницы и подходит для очистки одноразовой работы.

Некоторые параметры создания добавляют репозитории, учетные данные, навыки или сервисы уже после запуска VM. Тогда успешное создание может вернуть provisioning.status: in_progress; перед использованием результата дождитесь ready.

Доступ внутри организации​

Новые песочницы, созданные через REST или веб-интерфейс, по умолчанию личные для автора. Выберите видимость org, чтобы другие участники организации могли видеть песочницу и ее диагностические данные. Участник видит свои личные и общие песочницы; пользователи с ролью Владелец или Администратор организации видят все песочницы аккаунта. Песочницу с записанным автором могут изменять только этот автор и пользователи с ролью Владелец или Администратор. Исторические общие песочницы без записанного автора сохраняют прежний доступ для организации. Ответ API содержит permissions для текущего пользователя.

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

URL превью и другие ссылки, по которым песочница открывается без входа, — отдельный способ доступа. Личная видимость не отзывает ссылки, выданные ранее.

Личную песочницу можно сохранить как новый шаблон. Созданный шаблон доступен всем участникам аккаунта организации. Его корневая файловая система может содержать файлы, настройки и секреты, записанные на диск исходной песочницы; другие участники смогут создать из этого образа собственную песочницу. Перед сохранением проверьте содержимое.

Основные задачи​

Границы​

Файловая система песочницы — не хранилище аккаунта. Доступ к хранилищу выдается отдельно. Шаблон задает начальное окружение, но не является запущенной песочницей. Автоматизация нацелена на песочницу, однако владеет собственным триггером и историей запусков.

Начать сейчас​

Выберите быстрый старт через веб-интерфейс, API или AI-агента.