Введение#
Для запуска FaceStream с помощью данной документации необходимо наличие запущенной LUNA PLATFORM в соответствии с документацией по установке LUNA PLATFORM. При необходимости можно запустить FaceStream с помощью предварительного запуска минимально необходимых сервисов LUNA Configurator, LUNA Licenses, PostgreSQL и InfluxDB/ClickHouse (см. документ "Руководство по установке без запущенной LP").
Данный документ описывает:
- ручной процесс запуска приложения FaceStream и LUNA Streams с помощью Docker;
- автоматическое развертывание приложения FaceStream с помощью Docker Compose.
FaceStream может быть запущен в одном из двух режимов:
- Через LUNA Streams — режим, при котором потоки создаются в сервисе LUNA Streams (используется по умолчанию). Требует развертывания и настройки LUNA Streams.
- В роли агента LUNA PLATFORM — режим, при котором FaceStream регистрируется как агент в уже развёрнутом сервисе LUNA Video Manager и получает потоки через его API. Не требует развертывания LUNA Streams.
Выбор режима регулируется параметром pull_streams_service в конфигурационном файле. При запуске с помощью Docker Compose этот параметр автоматически изменяется с помощью флага --mode.
Перед запуском необходимо ознакомиться с общей информацией и последовательностью действий.
Лицензирование FaceStream зависит от выбранного режима работы. Для режима через LUNA Streams используется лицензионный ключ LUNA PLATFORM, определяющий количество потоков для работы LUNA Streams. Для режима агента LUNA PLATFORM используется лицензионный ключ для Luna Video Manager. Таким образом, в обоих случаях для работы FaceStream необходима лицензия LUNA PLATFORM. Лицензия должна быть активирована перед запуском FaceStream.
Скрипт Docker Compose из данного дистрибутива используется для развертывания LUNA Streams и FaceStream на одном сервере (для режима через LUNA Streams) или только FaceStream (для режима агента LUNA PLATFORM).
Считается, что запуск выполняется на сервере с операционной системой Almalinux, где FaceStream не был установлен.
Администратор должен вручную настроить Firewall и SELinux на сервере. В данном документе не описывается их настройка.
Данный документ не включает руководство по использованию Docker. Пожалуйста, обратитесь к документации Docker для более подробной информации:
В данном документе приведены примеры разворачивания FaceStream в минимальной рабочей конфигурации для использования в демонстрационных целях. Данная конфигурация не является достаточной для реальной эксплуатации системы в продуктивном контуре.
Все описываемые команды необходимо исполнять в оболочке Bash (когда команды запускаются напрямую на сервере) или в программе для работы с сетевыми протоколами (в случае удаленного подключения к серверу), например, Putty.
Подробную информацию по общей работе и настройках приложения см. в руководстве администратора FaceStream.