Песочница и инфраструктура
Локальная песочница
Когда агент выполняет для вас реальную работу — запускает ваш сайт, открывает браузер, чтобы проверить интерфейс, или обращается к базе данных для тестов — ему нужна безопасная изолированная среда. Каждый проект получает собственный набор таких инструментов, отделённый от других ваших проектов и от инфраструктуры платформы.
1
Что можно делать
Агент может запускать Docker-контейнеры вашего проекта (например,
docker compose up), чтобы поднять и протестировать окружение вашего продукта — без риска повлиять на другие проекты.Агент может открывать браузер, чтобы визуально проверить работу веб-интерфейса, сделать скриншот или кликнуть по элементам страницы — как это делает реальный пользователь.
Для агентов, которым это не требуется по роли, браузер не подключается — это экономит ресурсы и ускоряет их ответы.
Вы можете в любой момент посмотреть, запущена ли Docker-песочница проекта, сколько места она занимает, и вручную остановить, перезапустить или очистить её.
Вы получаете уведомление, если состояние песочницы меняется — например, она была остановлена.
2
Как попасть
Раздел «Инфраструктура» в административном меню → вкладка «Локальная песочница» → подвкладка «Docker». Доступен владельцу проекта, администратору и участникам команды с выданным доступом к инфраструктуре.
Инфраструктура
Локальная песочница
Docker
3
Экраны раздела
Статус песочницы
Показывает, запущена ли Docker-песочница проекта прямо сейчас, и сколько места на диске она занимает.
Статус локальной песочницы
- Цветной значок показывает, запущена ли песочница сейчас: зелёный «Запущен» или серый «Не запущен». Если не запущена — это нормально: она поднимется автоматически, как только агент выполнит первую Docker-команду в проекте.
- Ниже — сколько места на диске занимают образы и данные песочницы, и когда в последний раз выполнялась очистка кэша.
- Кнопка «Обновить» вверху страницы обновляет цифры вручную; статус запуска/остановки обновляется и сам по себе, как только меняется в реальности.
Действия
Три кнопки управления песочницей — ни одна из них не приводит к потере ваших данных.
Кнопки управления
- «Перезапустить» — доступна, только если песочница сейчас запущена. Останавливает её; агент поднимет её заново при следующей Docker-команде.
- «Очистить кэш сейчас» — удаляет неиспользуемые образы и промежуточные слои сборки, освобождая место на диске. Данные ваших баз данных и других постоянных томов эта операция не трогает.
- «Остановить» — полностью останавливает песочницу и освобождает ресурсы сервера. Как и перезапуск, не приводит к потере данных.
4
Типичные действия
Проверить, работает ли песочница
- Откройте «Инфраструктура» → «Локальная песочница» → «Docker».
- Посмотрите на цветной значок статуса.
Освободить место на диске
- Откройте вкладку Docker.
- Нажмите «Очистить кэш сейчас» — данные ваших сервисов не пострадают.
Перезапустить зависшую песочницу
- Откройте вкладку Docker.
- Нажмите «Перезапустить» — она поднимется заново, как только агент выполнит следующую Docker-команду.
5
Частые вопросы и ограничения
Ограничения
- Песочница создаётся не заранее, а по факту первой Docker-команды агента в проекте — «Не запущен» до этого момента является нормальным состоянием.
- Очистка кэша не удаляет данные ваших сервисов (баз данных и т.п.) — только временные файлы сборки.
- Управлять песочницей может владелец проекта, администратор или участник команды с выданным доступом к инфраструктуре.
- Удаление проекта автоматически останавливает и убирает всю его песочницу.