Запуск LUNA PLATFORM#
Запуск Docker Compose осуществляется с помощью скрипта "start_platform.sh", расположенного в директории "example-docker".
При необходимости можно модифицировать скрипт запуска Docker Compose под пользовательские нужды. Модификация скрипта предназначена только для опытных пользователей.
Во время запуска скрипта будет создан стандартный аккаунт типа user с логином user@mail.com
и паролем password
. Инструкция по созданию собственного аккаунта приведена ниже.
См. подробную информацию об аккаунтах в разделе "Аккаунты, токены и способы авторизации" руководства администратора.
Запуск сервисов#
Откройте директорию Docker Compose:
cd /var/lib/luna/current/example-docker
Убедитесь в том, что контейнеры LP не запущены до выполнения скрипта. Попытка запустить контейнер с таким же именем, как существующий контейнер, приведет к ошибке. Если запущен один или несколько контейнеров LP, необходимо остановить их с помощью команды
docker container rm -f <container_name>
. Чтобы остановить все контейнеры, используйтеdocker container rm -f $(docker container ls -aq)
.
Запуск Docker Compose:
Необходимо выполнить вход в VisionLabs registry (см. раздел "Вход в registry")
./start_platform.sh --common
Скрипт поддерживает следующие аргументы:
--common
- подготовка окружения с профилемcommon
и запуск LUNA PLATFORM без Backport'ов и сервисов Video Manager и Video Agent--extra backport3
- при активации вместе с--common
будет использован профильbackports
при подготовке окружения, а также запущен сервис Backport3 и его пользовательский интерфейс--extra backport4
- при активации вместе с--common
будет использован профильbackports
при подготовке окружения, а также запущен сервис Backport3 и его пользовательский интерфейс--extra videoanalytics
- при активации вместе с--common
будет включено использование сервиса Video Manager и Video Agent в настройке "ADDITIONAL_SERVICES_USAGE", а также запущены сервисы Video Manager и Video Agent--help/-h
- вывод справочной информации
Комбинирование флагов --extra backport3
, --extra backport4
, и --extra videoanalytics
вместе с --common
позволяет включить сразу несколько дополнительных сервисов.
Использование флагов --extra
без флага --common
невозможно.
Если аргументы не заданы, скрипт выполнит развертывание LUNA PLATFORM аналогично аргументу --common
.
Развертывание контейнеров требует времени. Необходимо дождаться того, чтобы все сервисы были запущены перед началом работы с LUNA PLATFORM.
Проверьте статус всех запущенных Docker-контейнеров.
docker ps
Запуск Remote SDK с использованием GPU#
Сервис Remote SDK не использует GPU по умолчанию. Если вы собираетесь использовать GPU, то следует включить его использование для сервиса Remote SDK в сервисе Configurator.
Если необходимо использовать GPU сразу для всех эстиматоров и детекторов, то необходимо использовать параметр "global_device_class" в секции "LUNA_REMOTE_SDK_RUNTIME_SETTINGS". Все эстиматоры и детекторы будут использовать значение данного параметра, если в параметре "device_class" их собственных настроек выставлено значение "global" (по умолчанию).
Если необходимо использовать GPU для определенного эстиматора или детектора, то необходимо использовать параметр "device_class" в секциях вида "LUNA_REMOTE_SDK_
См. раздел "Вычисления с помощью GPU" для получения дополнительных требований к использованию GPU.
Создание аккаунта#
Примечание. При запуске скрипта Docker Compose автоматически создается аккаунт типа "user" с логином "user@mail.com" и паролем "password". Инструкция по созданию аккаунта со своими аутентификационными данными приведена ниже.
Аккаунт создается с помощью HTTP-запроса к ресурсу "create account".
Аккаунт также можно создать с помощью сервиса Admin. Данный способ требует наличия существующих логина и пароль (или логина и пароля по умолчанию) и позволяет создать аккаунты типа "admin". См. подробную информацию в разделе "Сервис Admin" руководства администратора.
Для создания аккаунта с помощью запроса к сервису API необходимо указать следующие обязательные данные:
- login — электронный адрес
- password — пароль
- account_type — тип аккаунта ("user" или "advanced_user")
Создайте аккаунт, используя свои аутентификационные данные.
Пример CURL-запроса к ресурсу "create account":
curl --location --request POST 'http://127.0.0.1:5000/6/accounts' \
--header 'Content-Type: application/json' \
--data '{
"login": "user@mail.com",
"password": "password",
"account_type": "user",
"description": "description"
}'
Необходимо заменить аутентификационные данные из примера на свои.
См. подробную информацию об аккаунтах в разделе "Аккаунты и типы авторизации" руководства администратора.
Для работы с токенами необходимо наличие аккаунта.
Активация расписания задачи GC#
Перед началом работы с LUNA PLATFORM можно создать расписание для задачи Garbage collection.
Для этого следует выполнить запрос "create tasks schedule" к сервису API, указав необходимые правила для расписания.
Пример команды создания расписания для аккаунта из раздела "Создание аккаунта", приведен ниже.
В примере задается расписание для задачи Garbage collection для событий старше 30 дней с удалением БО и исходных изображений. Задача будет повторяться один раз в сутки в 05:30 утра.
curl --location --request POST 'http://127.0.0.1:5000/6/tasks/schedules' \
--header 'Authorization: Basic dXNlckBtYWlsLmNvbTpwYXNzd29yZA==' \
--header 'Content-Type: application/json' \
--data '{
"task": {
"task_type": 4,
"content": {
"target": "events",
"filters": {
"create_time__lt": "now-30d"
},
"remove_samples": true,
"remove_image_origins": true
}
},
"trigger": {"cron": "30 5 * * *", "cron_timezone": "utc"},
"behaviour": {"start_immediately": false, "create_stopped": false}
}'
При необходимости можно создать расписание без его автоматической активации. Для этого нужно указать параметр "create_stopped": "true". В таком случае после создания расписания его необходимо активировать вручную с помощью параметра "action" = "start" запроса "patch tasks schedule".
См. подробную информацию в разделе "Запуск задач по расписанию" руководства администратора.
Включение Grafana и Loki#
Примечание. Выполняйте следующие действия если хотите использовать LUNA Dashboards (Grafana) и Loki. В противном случае, пропустите данный шаг.
Для использования Grafana и Loki можно выполнить скрипт start_logging.sh
, запускающий сервис LUNA Dashboards, Loki и Promtail. Данный скрипт нужно выполнять после запуска основного скрипта Docker Compose.
См. подробную информацию о визуализации мониторинга в разделах "LUNA Dashboards" и "Grafana Loki" руководства администратора.
Откройте директорию Docker Compose:
cd /var/lib/luna/current/example-docker
Запустите Docker Compose:
./start_logging.sh
Проверьте статус запущенных Docker-контейнеров.
docker ps