Сервер — это физическая машина, на которой живут ваши фабрики. MultiAgent подключается к ней по SSH: по паролю или по закрытому ключу. Если сам MultiAgent установлен на Windows, вместо SSH можно указать локальный дистрибутив WSL. Подключение хранится один раз на машину — адрес, порт, имя пользователя, пароль или ключ и промежуточный хост, — а каждая фабрика хранит только ссылку на свою машину.
На одной машине спокойно уживаются несколько фабрик, и подключение у них общее. Поэтому учётные данные вводятся один раз: сменили пароль — следующая же команда на любой фабрике этой машины пойдёт с новым паролем, править каждую фабрику по отдельности не нужно.
Список серверов
Раздел «Активы → Серверы» — таблица машин. В строке видно имя и адрес (если своего имени у записи нет, показывается один адрес), значок способа подключения, логин и порт, число ссылающихся фабрик и значок состояния связи: зелёный — связь есть, красный — подключиться не удалось, серый — машину ещё не проверяли. Наведите курсор на значок, чтобы прочитать, чем закончилась последняя проверка. Справа в строке — действия «Проверить подключение», «Изменить» и «Удалить»; клик по самой строке открывает ту же форму.
Добавление сервера
Кнопка «Новый сервер» открывает форму подключения. В ней «Имя» — как машина называется в интерфейсе. Поле необязательное: если оставить его пустым, именем станет адрес машины.
Дальше выбирают способ подключения: по SSH — тогда задаются «Адрес», «Порт SSH», «Имя пользователя» и «Аутентификация» (по паролю или по закрытому ключу); либо к локальному дистрибутиву WSL — этот вариант предлагается только там, где WSL действительно доступен, и тогда указывают дистрибутив, а учётные данные не нужны вовсе.
Пароль и закрытый ключ хранятся в зашифрованном виде и никогда не показываются обратно: в форме видно только, заданы они или нет («Пароль задан», «Ключ задан»), а рядом есть кнопка «Очистить». При редактировании пустое поле означает «оставить как было».
Ниже — раздел промежуточного хоста (ProxyJump). Он нужен, когда машина доступна не напрямую, а через другую: «Хост ProxyJump», «Порт ProxyJump» и «Имя пользователя ProxyJump». Пустой хост означает прямое подключение, а пустые имя пользователя и учётные данные берутся с самой машины.
Две записи на одну и ту же машину не создадутся: если такой адрес (а для WSL — такой дистрибутив) уже занят, форма скажет, какая запись его занимает.
Эту же форму открывает добавление фабрики: в списке машин есть пункт «Новый сервер…», так что машину можно завести, не прерывая настройку. Машина, выбранная при добавлении фабрики, запоминается в браузере — в следующий раз форма откроется на ней же.
Связь с сервером
MultiAgent сам следит за связью: раз в пять минут (а при запуске — уже через полминуты) он отправляет на каждую машину короткую проверку. Проверка одна на машину, сколько бы фабрик на ней ни жило. Итог сохраняется в записи машины, поэтому значок состояния обновляется сам, без перезагрузки страницы, сразу на всех открытых экранах — в списке серверов, в списке фабрик и в шапке фабрики.
Кнопка «Проверить подключение» запускает такую же проверку вручную и показывает её ход: строки отчёта появляются по мере выполнения. Итог — «Подключение успешно» или «Ошибка подключения» — записывается в ту же запись, так что он остаётся виден и после перезагрузки страницы.
Одно постоянное соединение
Все команды, работа с файлами и туннели к машине идут через одно постоянное соединение вместо нового на каждую операцию. Поэтому страницы и опросы отвечают быстрее, а сама машина видит одну сессию вместо десятков. Если служба SSH на машине перезапустилась, связь восстанавливается сама: следующая операция просто открывает новое соединение — ни ошибки, ни перезапуска MultiAgent не требуется. После смены учётных данных соединение открывается заново уже с новыми данными. Закрывается оно, когда удаляют последнюю фабрику машины или саму запись сервера.
Удаление
Пока на машину ссылается хотя бы одна фабрика, удалить её нельзя: вместо удаления появится сообщение с числом таких фабрик. Сначала удалите или перенесите фабрики — тогда запись сервера можно будет убрать.
Зарезервированный адрес
Первая часть адреса страницы — servers — закреплена за этим разделом. Имя servers нельзя дать агенту, приложению или инструменту: служебная страница всегда остаётся доступной и никакая строка её не перекроет.
Что дальше
- Оборудование — сколько на этих машинах занято процессора, памяти и дискового места: видно, когда пора добавлять мощности;
- Фабрики — что именно развёрнуто на машинах и как этим управлять.