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

Настройка модулей

Модуль - это вариант реализации конкретного сервиса Image API. Например, для сервиса face-detector-liveness-estimator доступны три модуля на выбор:

• liveness-anti-spoofing
• quality-liveness-anti-spoofing
• face-detector-liveness-estimator

Модули liveness-anti-spoofing и face-detector-liveness-estimator отличаются друг от друга алгоритмами определения liveness. В модуле quality-liveness-anti-spoofing дополнительно перед расчётом liveness выполняется оценка качества изображения, при этом порог качества (threshold) (значение по умолчанию - 30) позволяет исключить из пайплайна обработки изображения с недостаточным качеством.

Для смены модуля найдите в файле ./cfg/image-api.values.yaml конфиг интересующего сервиса в processing.services и поменяйте в нем значение поля module.

Пример конфига сервиса quality-assessment-estimator:

quality-assessment-estimator:
      …………
      module: quality-assessment-estimator
      …………

Перечень доступных модулей для каждого сервиса Image API:

Сервис	Модули
face-detector-face-fitter	face-detector-face-fitter - стандартный модуль
body-detector	body-detector - стандартный модуль
age-estimator	age-estimator - стандартный модуль
emotion-estimator	emotion-estimator - стандартный модуль
gender-estimator	gender-estimator - стандартный модуль
mask-estimator	mask-estimator - стандартный модуль
face-detector-liveness-estimator	face-detector-liveness-estimator - стандартный модуль liveness-anti-spoofing - более медленный, но более точный модуль quality-liveness-anti-spoofing - модуль liveness-anti-spoofing с дополнительной проверкой качества перед вычислением liveness
verify-matcher	verify-matcher - стандартный модуль
face-detector-template-extractor	face-detector-template-extractor - стандартный модуль
quality-assessment-estimator	quality-assessment-estimator - стандартный модуль

Настройка объектов конфигурации

В сервисах Image API используется набор объектов конфигурации, в которых реализована функциональность Face SDK:

• capturer: детекция лиц
• recognizer: сравнение лиц
• liveness-estimator: оценка liveness

Например, для сервиса face-detector-liveness-estimator существует 2 объекта конфигурации: capturer и liveness-estimator.

Выполнить настройку объекта конфигурации можно в файле ./cfg/image-api.values.yaml в блоке конкретного сервиса в атрибуте configs.

У объекта конфигурации определено 2 поля:

• name - имя файла конфигурации Face SDK.
• params - параметры, которые необходимо переопеределить в этой конфигурации.

Масштабирование

В случае, когда нагрузка возрастает, для стабилизации работы Image API предусмотрено масштабирование деплойментов, описанных в пункте Установка Image API в кластер в ручном режиме:

Для масштабирования установленного релиза необходимо выполнить следующую команду:

$ kubectl scale deployment <deployment_name> --replicas <count>

где <deployment_name> - наименование деплоймента (например, face-detector-dep), а <count> - количество реплик деплоймента (pods).

Для сохранения состояния масштабирования необходимо установить значение replicas под ключом интересующего сервиса в processing.services в файле ./cfg/image-api.values.yaml и перезапустить развертывание командой:

$ ./cli.sh image-api install