Карта продукта и основные понятия
Центральная сущность Just Run — песочница. Остальные сущности задают, как она создается, предоставляют данные и учетные данные, запускают работу внутри нее либо публикуют долговременный сервис на ее основе.
Основная модель
| Сущность | За что отвечает | Связь с песочницей |
|---|---|---|
| Песочница | Запущенное или приостановленное вычислительное окружение, его файловая система, процессы, настройки и опубликованные порты | Место выполнения команд и сервисов |
| Шаблон | Версионируемая начальная файловая система и значения ресурсов по умолчанию | Песочница создается из одной версии шаблона |
| Пресет | Ресурсы запуска и необязательные настройки подготовки для одного шаблона | Заполняет форму создания. В запросе создания через REST API пресет можно указать в preset_id: он дополнит запрос недостающими настройками подготовки и ресурсами. Без preset_id, как и при создании через MCP управления платформой, пресет шаблона по умолчанию дополняет запрос только настройками подготовки |
| Автоматизация | Cron- или вебхук-триггер и вызываемое действие | Запускает команду или HTTP-действие в существующей песочнице |
| MCP-хостинг | Управляемое определение MCP-сервера и постоянный эндпоинт для клиента | Работает в отдельной песочнице mcp-<имя>, которую Just Run создает сам; эта песочница видна в списке песочниц тем, кому виден Hosted MCP |
| Хранилище | Объектное хранилище уровня аккаунта | Отделено от файловой системы песочницы; доступ выдается явно |
| Секрет | Переиспользуемые учетные данные или конфигурация | Указывается по имени; сервер расшифровывает секрет и подставляет значения при создании песочницы или развертывании Hosted MCP |
| Навык | Инструкции для ассистента или файлы, устанавливаемые в песочницу | Навыки плагина Just Run расширяют Claude Code или Codex на вашем компьютере; навыки песочницы входят в ее состав |
Файловая система песочницы и хранилище
Файлы внутри песочницы принадлежат ей. Остановка и последующий запуск сохраняют файловую систему, а удаление песочницы безвозвратно удаляет и ее файлы.
Хранилище аккаунта — отдельное объектное хранилище. В файловую систему песочницы оно не монтируется. Доступ на чтение или на чтение и запись песочница получает, только если его выбрали при создании песочницы или позже в ее настройках.
Шаблон и пресет
Шаблон — переиспользуемая стартовая точка машины. Пресет — сохраненный набор значений для создания песочницы. После выбора пресета в блоке Дополнительные настройки формы создания можно изменить:
- шаблон и его версию, если у шаблона есть версии;
- ресурсы;
- все, что входит в блок Интеграции: секреты, переменные окружения, MCP-серверы, навыки и внешний доступ.
Контекст аккаунта
Ресурсы относятся к активному личному аккаунту или организации. Пользователь может переключать контекст, а API-операции используют контекст из токена или сессии. Список песочниц показывает только песочницы активного аккаунта — даже администратору платформы; песочницы всех аккаунтов он видит в Админке.
В организации личными и общими бывают:
- песочницы
- секреты
- автоматизации
- Hosted MCP
Новые ресурсы по умолчанию личные: их видят автор и пользователи с ролью Владелец или Администратор. Общие ресурсы видят все участники организации. Список песочниц в организации открывается с фильтром Только мои: чтобы увидеть общие песочницы коллег, выключите его.
Выбор сущности
- Используйте песочницу для интерактивной работы, изолированного выполнения команд и сервисов с управляемым жизненным циклом.
- Используйте автоматизацию, когда в существующей песочнице нужно запускать команду или HTTP-запрос по расписанию или по входящему вебхуку.
- Используйте MCP-хостинг, когда результатом должен быть постоянный MCP-эндпоинт, а не универсальная песочница.
- Используйте хранилище для объектов, которые должны переживать жизненный цикл одной песочницы или быть общими для нескольких песочниц.