Версия: 2.2.0

Установка

Подготовка к развертыванию

Подготовка

Форма поставки Image API – дистрибутив. В дистрибутиве лежат файлы, необходимые для развертывания Image API. Ссылка на скачивание дистрибутива и прикрепленный файл лицензии передаются клиенту по электронной почте.

Распакуйте дистрибутив и переместите файл лицензии face_sdk.lic в папку setup распакованного дистрибутива Image API.

Дальнейшие команды следует выполнять относительно директории setup.

Конфигурация

Название файла конфигурации	Описание
./cfg/image-api.values.yaml	Файл конфигурации развертывания экземпляра Image API
./cfg/package.settings.cfg	Файл конфигурации зависимостей для установки Kubernetes-кластера
./cfg/smc.settings.cfg	Файл конфигурации Kubernetes-кластера

1. Откройте файл ./cfg/smc.settings.cfg, используя текстовый редактор, и установите значения следующих переменных:

apiserver_advertise_address - внутренний IP-адрес машины, на которой выполняется развертывание.
external_ip_address - публичный IP-адрес машины, на который будет настраиваться DNS.

примечание

При отсутствии публичного IP-адреса используйте внутренний IP-адрес.

2. Откройте файл ./cfg/image-api.values.yaml, используя текстовый редактор, и установите значения следующих переменных:

ingress.host - доменное имя, используется в ingress для маршрутизации запросов на сервисы Kubernetes.

IP-адрес для доменного имени <ingress.host> должен быть сконфигурирован на DNS-сервере.

Установка зависимостей

Если в системе отсутствует Docker, Kubernetes, Helm выполните следующую команду:

./cli.sh package install

Загрузка образов

Загрузите в локальный registry docker-образы image-api:

./cli.sh image-api load-images

Загрузите в локальный registry docker-образы smc:

./cli.sh smc load-images

Загрузка образов может длиться около пяти минут.

Установка и настройка кластера

Запустите команду для создания и настройки кластера:

./cli.sh smc install

Эта команда выполняет следующие действия:

Настройка docker и сети хоста
Установка кластера
Установка ingress-controller
Установка flannel

Для использования GPU необходимо установить nvidia-device-plugin командой:

./cli.sh smc nvidia install 

Для использования Horizontal Pod Autoscaler необходимо установить metric-server командой:

./cli.sh smc metric-server install

Запустите следующую команду для создания секретов image-api в кластере:

./cli.sh image-api install-secrets

Проверка работоспособности кластера

После инициализации главного узла убедитесь, что он готов к работе. Для проверки выполните следующую команду:

kubectl get nodes

В результате в терминале будет отображен следующий вывод:

NAME          STATUS      ROLES                   AGE     VERSION
master-node   Ready       control-plane,master    1d     v1.23.8

Развертывание

Установка Image API в кластер

Запустите скрипт для установки Image API в кластер:

./cli.sh image-api install

Для получения статуса работы развертывания выполните команду:

kubectl get pods

В терминал будет выведен список под (pods - экземпляров деплоймента), их статус, количество перезапусков и время с момента создания.

Пример вывода:

NAME                                                READY    STATUS     RESTARTS   AGE
image-api-age-estimator-dep-5bf7889dcd-jm46h         1/1     Running        0      1h
image-api-body-detector-dep-6778495696-4zkpm         1/1     Running        0      1h
image-api-emotion-estimator-dep-7c8cdd7c6b-z4vlv     1/1     Running        0      1h
image-api-face-detector-face-fitter-dep-5fb48dcb5…   1/1     Running        0      1h
image-api-gateway-dep-65d4846c59-g2nfj               1/1     Running        0      1h
image-api-gender-estimator-dep-86b9457f9b-2464q      1/1     Running        0      1h
image-api-face-detector-liveness-estimator-dep-7bd…  1/1     Running        0      1h
image-api-liveness-estimator-dep-9823475912-9xqfp    1/1     Running        0      1h
image-api-mask-estimator-dep-76b958b84b-w7pss        1/1     Running        0      1h
image-api-quality-assessment-estimator-dep-fbf8bc4…  1/1     Running        0      1h
image-api-face-detector-template-extractor-dep-5758… 1/1     Running        0      1h
image-api-template-extractor-dep-6778489659-6zkmp4   1/1     Running        0      1h
image-api-verify-matcher-dep-6d66dc4948-lx8j7        1/1     Running        0      1h

примечание

Наличие у всех под (pods) статуса Running означает, что все контейнеры успешно запущены.

Ниже приведено краткое описание деплойментов:

image-api-gateway-dep: обратный прокси-сервер, отвечает за единый доступ к сервисам обработки;
image-api-face-detector-face-fitter-dep: детекция лица и вычисление антропометрических точек лица и углов поворота головы;
image-api-body-detector-dep: детекции тела;
image-api-emotion-estimator-dep: оценка эмоций;
image-api-age-estimator-dep: оценка возраста;
image-api-gender-estimator-dep: оценка пола;
image-api-face-detector-liveness-estimator-dep: детекция лица и оценка принадлежности лица на изображении реальному человеку (liveness);
image-api-liveness-estimator-dep: оценка принадлежности лица на изображении реальному человеку (liveness);
image-api-mask-estimator-dep: оценка наличия/отсутствия медицинской маски на лице человека;
image-api-quality–assessment-estimator-dep: оценка качества изображения;
image-api-verify-matcher-dep: сравнение двух биометрических шаблонов;
image-api-face-detector-template-extractor-dep: детекция лица и извлечение биометрического шаблона лица с изображения;
image-api-template-extractor-dep: извлечение биометрического шаблона лица с изображения.

Настройка DNS

Для обеспечения доступа DNS сервер вашей сети должен содержать запись о том, что домен <host> доступен по адресу <external_ip_address>. Значения переменных можно получить из файлов ./cfg/smc.settings.cfg и ./cfg/image-api.values.yaml, заполненных в пункте Конфигурация. Чтобы выполнить данную конфигурацию, обратитесь к администратору вашей сети.

Для целей тестирования можно указать IP-адрес и домен в файле /etc/hosts на Linux или C:\Windows\System32\drivers\etc\hosts на Windows. Для этого добавьте в конец данного файла новую строку вида <external_ip_address> <host>, подставив значения соответствующих переменных, и сохраните файл. Обратите внимание, что для редактирования файла hosts необходимо обладать правами администратора.

Для использования Image API с той же машины, где выполнено развертывание, можно воспользоваться скриптом, который автоматически добавит необходимую запись в файл /etc/hosts.

echo "<external_ip_address> <host>" | sudo tee -a /etc/hosts

Проверка работы

Для проверки работы выполните команду ниже:

./cli.sh image-api test - http://<host>

Вывод теста должен иметь следующий вид:

face-detector-face-fitter ✓
age-estimator ✓
emotion-estimator ✓
gender-estimator ✓
face-detector-liveness-estimator ✓
liveness-estimator ✓
mask-estimator ✓
quality-assessment-estimator ✓
face-detector-template-extractor ✓
template-extractor ✓
body-detector ✓
verify-matcher ✓

Удаление

Для удаления Image API выполните следующую команду:

./cli.sh image-api uninstall

Лицензирование

Установка лицензии

Распакуйте дистрибутив Image API и переместите файл лицензии face_sdk.lic (файл прикреплен к электронному письму) в папку setup.

Обновление лицензии

Переустановите секреты.

./cli.sh image-api install-secrets

Удалите релиз из кластера.

./cli.sh image-api uninstall

Установите релиз в кластер.

./cli.sh image-api install

Подготовка к развертыванию​

Подготовка​

Конфигурация​

Установка зависимостей​

Загрузка образов​

Установка и настройка кластера​

Проверка работоспособности кластера​

Развертывание​

Установка Image API в кластер​

Настройка DNS​

Проверка работы​

Удаление​

Лицензирование​

Установка лицензии​

Обновление лицензии​