Worktree по SSH
Запуск агентов и Git worktree на удалённом компьютере по SSH.
Через SSH Orca запускает агентов и Git на удалённом компьютере. Такой режим подходит для долгих сборок, GPU-серверов и задач, которые не должны нагружать ноутбук.
Один из четырёх режимов
SSH является одним из способов удалённых вычислений. Локальный запуск, собственные серверы и временные виртуальные машины описаны в статье Способы запуска Orca.
Добавление узла
- Откройте Настройки → SSH.
- Укажите адрес, пользователя, порт и при необходимости ключ. Orca также импортирует узлы из конфигурации OpenSSH и файлов
Include. - Для защищённого паролем ключа Orca запросит пароль при первом подключении.
- Нажмите Проверить.
Использование
При создании worktree выберите узел SSH вместо локального компьютера. Orca создаст git worktree на сервере, запустит там агентов и синхронизирует события файлов для локальной работы редактора и diff.
Дополнительные параметры
В редакторе узла раскройте Дополнительное подключение для прокси, промежуточного узла и мультиплексирования. По умолчанию повторно используется соединение OpenSSH в macOS и Linux. Отключайте это только для серверов, запрещающих совместные сессии.
Пароли ключей
Пароли хранятся в памяти до закрытия Orca. В настройках SSH можно увеличить срок хранения.
Состояние
Зелёный индикатор означает подключение, жёлтый повторное соединение, красный отключение. Разрыв не завершает агента: Orca подключится снова. Состояния агента передаются по SSH и видны в ленте агентов.
Сессии после закрытия
Закрытие приложения не завершает удалённые PTY. Ретранслятор на сервере удерживает их, а после открытия Orca возвращает вкладки и историю. Период ожидания по умолчанию равен пяти минутам и настраивается для узла.
Загрузка файлов
В контекстном меню файла выберите Загрузить, чтобы сохранить его на ноутбуке. Действие доступно только в настольном приложении и использует системный диалог. Каталоги сначала нужно архивировать или копировать через терминал.
Перенаправление портов
Вкладка Порты на правой панели (Cmd+Shift+I) находит прослушиваемые порты через /proc/net/tcp. Их можно перенаправить одним нажатием, добавить вручную или удалить. Правила сохраняются после перезапуска и повторного подключения. Привилегированные порты автоматически получают локальный номер, например 80 превращается в 10080.
Частые вопросы
Что позволяет делать подключение по SSH?
Оно даёт возможность открыть удалённый репозиторий, создать там worktree и запустить агента на другом компьютере.
Где должен быть установлен агент?
CLI-агент устанавливается на удалённой машине, потому что именно там выполняются команды.
Какую SSH-аутентификацию лучше использовать?
Предпочтительны ключи с подходящими правами и защищённым хранением, а не пароль внутри команды.
Почему команда доступна в SSH-терминале, но не запускается Orca?
Интерактивная и неинтерактивная оболочки могут получать разный PATH, поэтому проверьте окружение фактической сессии.
Останутся ли изменения на сервере после отключения?
Да. Файлы находятся в удалённом worktree, но незавершённый процесс агента может остановиться в зависимости от способа запуска.