Задача
Существует веб-базированная Система для управления медиа. Необходимо реализовать локального агент, который будет взаимодействовать с Системой по REST API.
Необходимо написать скрипт для работы агента, который будет принимать запросы от Системы для скачивания файлов в локальное или сетевое местоположение по указанному пути.
Есть продуманное и подробно описанное ТЗ. Альтернативные предложения по реализации обсужаются
Основные задачи и характеристики агента
- Авторизация в системе и управление жизненным циклом токенов:
- Агент должен автоматически авторизовываться в системе, используя предоставленные учетные данные (логин и пароль) для получения accessToken и refreshToken.
- Агент должен автоматически обновлять accessToken, используя refreshToken, до истечения его срока действия, чтобы обеспечить непрерывный доступ к ресурсам системы без необходимости ручной переавторизации.
- Обработка запросов на перемещение файлов:
- Агент должен принимать HTTP POST запросы на скачивание файлов, содержащие информацию о имени файла и пути к директории назначения, как в локальном, так и в сетевом хранилище.
- Для каждого запроса агент помещает его в управляемую очередь, обрабатывая файлы в соответствии с их приоритетом и доступностью.
- Перемещение файлов:
- После получения запроса на скачивание, агент должен запросить доступ к файлу в S3, проверить его существование и доступность, а затем выполнить скачивание файла в указанную директорию.
- Агент должен поддерживать возможность остановки скачивания на любом этапе, если поступит соответствующая команда от системы.
- Отправка результатов выполнения операции:
- После каждой операции скачивания, агент должен отправлять в систему отчет о статусе операции (успех, ошибка), включая детали ошибки, если таковая произошла.
- Логирование:
- Агент должен вести детализированный журнал своей работы, включая информацию о полученных запросах, процессе скачивания, возникших ошибках и изменении статусов операций. Логи должны быть доступны для анализа в случае необходимости диагностики или отладки.
- Обработка изменений приоритета скачивания:
- Система может отправлять агенту запросы на изменение приоритета уже запланированных к скачиванию файлов. Агент должен уметь динамически изменять порядок обработки файлов в своей очереди в соответствии с новыми приоритетами.
- Проверка доступа локальным и к сетевым дискам
- Система может отправлять агенту запросы на проверку доступа к местоположениям, расположенным по сетевому адресу, предоставляя ip, путь, логин и пароль. Агент должен поддерживать механизм проверки аутентификационных данных (логин и пароль), предоставленных пользователем для доступа к сетевым ресурсам. Это включает в себя валидацию предоставленных учетных данных посредством попытки установления соединения с указанным ресурсом перед выполнением операций скачивания. В случае неудачи аутентификации, агент должен немедленно уведомить систему о невозможности доступа, предоставив соответствующий код ошибки и описание проблемы.
Помимо авторизации, необходимо убедиться, что указанный путь существует и доступен для операций чтения/записи. Это включает в себя проверку наличия целевой директории или файла по сетевому адресу. В зависимости от используемой операционной системы и инструментов, процесс может немного отличаться, но общий принцип следующий: - Система также может запрашивать у агента проверку доступности локальных ресурсов. В этом контексте агент обязан поддерживать функционал для проверки доступности указанных локальных путей, убедившись, что они доступны для чтения и записи перед выполнением заданий по скачиванию или загрузке файлов
Алгоритм работы
- Получить accessToken и refreshToken из эндпоинта системы: /test/api/auth/login
- Ожидать получения запроса на скачивание файла с указанным именем файла и именем директории.
- Полученный запрос положить в конец очереди сообщений. В случае, если у сообщений в очереди одинаковый приоритет - очередь работает в режиме FIFO.
- Проверять очередь сообщений на наличие новых сообщений. Первым брать в работу сообщение с наивысшим приоритетом.
- Запросить ссылку на файл из S3.
- Проверяем существование файла в S3.
- Если файл не существует - вернуть соответствующую ошибку.
- Проверить доступность директории.
- Если директория недоступна - вернуть соответствующую ошибку.
- Выполнить скачивание если п. 4.1 и 5.1 не вызывают ошибок.
- Если в директории уже существовал файл с таким названием - перезаписать его.
- После завершения скачивания вернуть сообщение об успехе или ошибку.
- Логировать успешное скачивание или ошибки при работе скрипта.
С полным ТЗ можно ознакомиться по ссылке: https://docs.google.com/document/d/13t3RdXOSzSVsIK...
