Ej-agent
Навигация: Главная страница/Система ejudge/Использование/Общая архитектура системы/ej-agent
Этот компонент отвечает за взаимодействие хостов компиляции и выполнения с сервером ejudge и необходим для организации компиляции и тестирования, распределенного в сети.
В качестве канала передачи данных для компиляции и тестирования используется канал удаленного входа в систему по протоколу ssh. Поэтому для компиляции и выполнения по сети должен быть настроен вход по ssh на сервер ejudge без пароля.
Компоненты компиляции ej-compile и тестирования ej-super-run выполняют команду
ssh EJUDGE-SERVER ej-agent
таким образом на сервере запускается компонент ej-agent, и он оказывается связанным с соответствующей компонентой компиляции или запуска через канал ssh. Компонент ej-agent получает данные с хоста компиляции или тестирования от компонента ej-compile или ej-super-run на своём стандартном потоке ввода, а данные, выводимые ej-agent на свой стандартный поток вывода, передаются по каналу ssh на хост компиляции или тестирования.
Протокол взаимодействия ej-agent и клиентской части основан на обмене сообщениями в формате JSON, бинарные данные сжимаются и кодируются base64 перед пересылкой. Протокол поддерживает передачу файлов в обе стороны, проверку наличия файлов в каталоге, а также подписку на изменение состояния каталога с последующим уведомлением.
Преимущество ej-agent по сравнению с опросом состояния файловой системы, примонтированной с помощью sshfs, в том, что ej-agent использует эффективные средства наблюдения за состоянием каталога (inotify) и может уведомить о событии немедленно после того, как оно случилось. В то время как при использовании sshfs возникали существенные задержки из-за необходимости постоянного опроса содержимого каталогов очередей при том, что список файлов в каталоге кешировался клиентом, то есть изменения в каталоге попадали клиентам не сразу.
При использовании ej-agent нет необходимости монтировать каталоги очередей и каталоги турниров, так как ej-agent поддерживает передачу файлов тестов, проверяющих программ и т. п. Кроме того, ej-agent не пересылает неизменившиеся файлы, что позволяет организовывать кеширование файлов турниров на тестирующих компьютерах.
Программа ej-agent поддерживает следующие аргументы командной строки:
-n QUEUE-ID
— идентификатор очереди, с которой будет выполняться обмен.-i INST-ID
— идентификатор подключающегося клиента; используется при записи в лог-файл.-m MODE
— режим работы:MODE
должен быть либоcompile
, либоrun
в зависимости от того, с какой очередью (компиляции или тестирования) требуется взаимодействовать.-v
— выводить принимаемые и отправляемые пакеты на стандартный поток ошибок, то есть в лог-файл.
Поддерживается начиная с версии 3.10.0.