Песочница и инфраструктура

Удалённый сервер

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

How it works — step by step

Projects

Connect server

Name

prod-server-1

Direct SSH

Reverse tunnel

Docker over TCP+TLS

Host

203.0.113.5

SSH username

deploy

1. Go to "Projects" and click "Sandbox"

Что можно делать

Подключить сервер тремя способами на выбор: по прямому SSH-доступу, через уже настроенный Docker с сертификатами, либо обратным подключением — если сервер находится за домашним роутером/файрволом и входящих подключений к нему нет.

Указать, в какую директорию на сервере класть код проекта — по умолчанию /opt/ai-team.

Проверить, что сервер готов к работе — одной кнопкой, с понятной расшифровкой, что именно не так, если что-то не готово.

В любой момент отвязать сервер от проекта — задачи автоматически вернутся на нашу инфраструктуру.

Переиспользовать один и тот же подключённый сервер сразу в нескольких своих проектах.

Перевыпустить ключи доступа, если старые нужно аннулировать — например, при подозрении на утечку.

Получить сообщение в общий чат проекта, если подключённый сервер стал недоступен — и когда связь с ним восстановится.

Видеть состояние сервера прямо в интерфейсе проекта: значок рядом с названием проекта обновляется сам, без перезагрузки страницы.

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

Как попасть

Управление серверами — на странице «Инфраструктура», вкладка «Удалённая песочница»: список ваших серверов, кнопка подключения нового и карточка каждого сервера с его статусом и действиями. Привязка конкретного сервера к конкретному проекту (или возврат на нашу инфраструктуру) делается отдельно — на странице «Проекты», иконкой сервера в карточке проекта.

Инфраструктура

Удалённая песочница

Три способа подключения

Экранов и скриншотов для этого раздела пока не снято — ниже описаны сами способы, доступные при подключении сервера.

Прямой SSH

Мы сами инициируем SSH-соединение с вашим сервером. Нужен только SSH-доступ и наш CLI на сервере — ход агента видит всё, что там уже есть, включая вашу базу данных. Рекомендуемый способ для SSH и обратного туннеля.

Docker по TCP+TLS

Подходит, если у вас уже открыт docker-демон с TLS-сертификатами. Ваш демон поднимает наш образ агента — так же, как наша собственная инфраструктура. Единственный режим исполнения для этого способа — через Docker.

Обратный туннель

Для серверов за NAT или файрволом без входящего доступа — сервер сам подключается к нашему sandbox-relay. Ключ для запуска туннеля показывается один раз, сразу после подключения, вместе с готовой командой: по умолчанию — docker run со служебным образом (нужен только Docker, туннель сам переподключается), либо команда autossh для серверов без Docker.

Частые вопросы и ограничения

Ограничения

Сервер подключается на пользователя, а не на проект — переключение между проектами делается вручную.
Способ подключения «Docker по TCP+TLS» поддерживает только режим исполнения через Docker — вариант с голым SSH-доступом для него недоступен.
Статус «Готов»/«Недоступен» на экране — результат последней проверки: он не блокирует запуск задач сам по себе, если сервер реально недоступен, задача просто завершится ошибкой.

Локальная песочница Шаблоны окружения