Локальная установка

Dbrain — серверное решение. Если вы хотите его протестировать, воспользуйтесь веб-демо. Мы не используем долговременного хранилища данных, все входящие файлы передаются на сервер по защищённому протоколу, обрабатываются в оперативной памяти и удаляются сразу после возврата результатов пользователю. В тестовых целях пригодится паспорт России из Википедии.

Воспользуйтесь инструкциями ниже, если хотите развернуть решение Dbrain в собственном закрытом IT-контуре.

Требования к аппаратной части

Сценарии использования:

1. Минимальный — не более 1 документа в минуту

Процессор: 6 ядер, 4,1 GHz, расширение AVX 2; ориентир: Intel Core i5-10600KF
Оперативная память: 32 Gb
Накопитель: 500 Gb SSD

2. Стандартный — до 20 документов в минуту

Процессор: 8 ядер, 3,9 GHz, расширение AVX 2; ориентир: Intel Xeon W-2245
Оперативная память: 64 Gb
Накопитель: 1 Tb NVMe

3. Корпоративный — до 200 документов в минуту

Процессор: 8 ядер, 3,9 GHz, расширение AVX 2; ориентир: Intel Xeon W-2245 x2
Оперативная память: 128 Gb
Накопитель: 1 Tb NVMe x2

Выше перечислены аппаратные требования для продуктивной эксплуатации. Dbrain запускается и на слабых конфигурациях, например на ноутбуке Core i5-8250U 1.6 GHz / 8 Gb ОЗУ / 250 Gb SSD. Тем не менее, работоспособность на таких слабых конфигурациях не гарантируется.

Требования к окружению:

Операционная система Ubuntu версии 18.04+
Система менеджмента контейнеров Docker
docker-compose
Доступ в интернет для проверки лицензии:
- Адрес: https://license.ml.dbrain.io/check/v2
- IP: динамический
- Порт: 443
- Протокол: TCP
- Запрос: POST

Конфигурационные файлы

I. docker-compose.yml

Создайте файл docker-compose.yml

Скопируйте следующие настройки:

version: "3"

services:

  queue:
    image: rabbitmq:3.7-management-alpine
    restart: always
    logging: &short_logging
      driver: "json-file"
      options:
        max-file: "10"
        max-size: "100m"

  redis:
    image: redis:6-alpine
    restart: always
    logging: *short_logging

  mongo:
    image: mongo:3.6-stretch
    restart: always
    logging:
      driver: none

  worker: &service
    image: registry.dbrain.io/public/worker:v3.6.12
    restart: always
    env_file: &env .env
    command: ""
    depends_on:
      - queue
      - mongo
      - redis
    logging: *short_logging
    volumes:
      - ./errlogs:/logs:rw

  front:
    image: registry.dbrain.io/public/docr-demo-nginx:v3.6.12
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/nginx.conf
    env_file: *env
    ports:
      - ${API_PORT:-8080}:80
    depends_on:
      - api

  api:
    <<: *service
    image: registry.dbrain.io/public/api:v3.6.12

  classifier:
    <<: *service
    image: registry.dbrain.io/public/classifier:v3.6.12

  multidocnet:
    <<: *service
    image: registry.dbrain.io/public/multidocnet:v3.6.12

  heuristics:
    <<: *service
    image: registry.dbrain.io/public/heuristics:v3.6.12

  wordnet:
    <<: *service
    image: registry.dbrain.io/public/wordnet:v3.6.12

  ocr:
    <<: *service
    image: registry.dbrain.io/public/ocr:v3.6.12

  fieldnet:
    <<: *service
    image: registry.dbrain.io/public/fieldnet:v3.6.12

  checkbox_segm:
    <<: *service
    image: registry.dbrain.io/public/checkbox-segm:v3.6.12

  table_handler:
    <<: *service
    image: registry.dbrain.io/public/table-handler:v3.6.12

  face:
    <<: *service
    image: registry.dbrain.io/public/face:v3.6.12

II. env и nginx.conf

Создайте файл .env:

VERSION=v3.6.10

# front
TRY_ENDPOINT=/try

DEFAULT_NORMALIZATION_FIAS=False

# Legacy - не работает, но необходимо для запуска
DADATA_TOKEN=
DADATA_SECRET=

AUTOCODE_REPORT=
AUTOCODE_TOKEN=

Скачайте файл nginx.conf:

725B

nginx.conf

Положите три файла docker-compose.yml, .env и nginx.conf в одну директорию.

Запуск Dbrain

Перейдите в директорию, содержащую три файла конфигурации. Введите в командой строке следующую команду:

docker-compose up -d --force-recreate

При необходимости добавьте параметры масштабирования сервисов (--scale).

Всё готово! Теперь вы можете использовать локальную версию веб-демо, открыв в браузере ссылку http://localhost:8080. Вы также можете обращаться к серверу с помощью API.

Вы можете установить Dbrain на компьютер с ОС Windows 10, но при этом вам доступна только CPU версия сервис. Для этого вам потребуется выполнить следующие шаги.

1. Установите Docker

Скачайте установщик Docker с официального сайта. Рекомендуем использовать версию из Stable channel.
Запустите установщик и следуйте инструкциям на экране. В конце установки нужно перезагрузить компьютер.
После перезагрузки проверьте область уведомлений в правом нижнем углу. Если там нет иконки с китом, скорее всего у вашей учётной записи нет прав для запуска Docker. В таком случае наберите слово Docker в поиске. Кликните правой кнопкой мыши по приложению Docker Desktop и выберите «Запуск от имени администратора».

2. Установите PowerShell

Скачайте установщик PowerShell из официального репозитория. Рекомендуем использовать stable версию из строки Windows (x64).
Запустите установщик и следуйте инструкциям на экране.
Наберите слово PowerShell в поиске. Кликните правой кнопкой мыши по приложению PowerShell и выберите «Запуск от имени администратора».

3. Проверьте, что среда подготовлена

Выполните в PowerShell команду docker version
Выполните команду docker run hello-world.
Если вы не получили ошибок на этих двух этапах, значит всё работает хорошо.

4. Подготовьте файл конфигурации .env

Создайте на компьютере папку с любым названием, например Dbrain. Создайте файл без названия с расширением env, у вас должно получиться .env. Откройте этот файл в текстовом редакторе, например, в Блокноте, и скопируйте туда содержимое окна ниже:

VERSION=v3.6.8

# front
TRY_ENDPOINT=/try

# Legacy
DADATA_TOKEN=
DADATA_SECRET=

AUTOCODE_REPORT=
AUTOCODE_TOKEN=

Замените текст «ваш_ключ_лицензии» на ваш ключ лицензии. Сохраните получившийся файл в папку Dbrain.

5. Подготовьте файлы конфигурации docker-compose.yml и nginx.conf

Скачайте файл docker-compose.yml и nginx.conf:

Положите эти файлы в папку Dbrain.

6. Выдайте Docker доступ к папке с файлами конфигурации

Нажмите правой кнопкой мыши на иконку кита Docker в правом нижнем углу экрана
Выберите пункт Settings в выпадающем меню
Выберите раздел Resources, подпункт File Sharing
Кликните иконке по синего плюса в круге и укажите путь к директории Dbrain, например C:\Dbrain
Нажмите кнопку Apply & Restart

7. Запуск Dbrain

Вернитесь в запущенный на шаге № 2 PowerShell
Перейдите в папку Dbrain с помощью команды cd C:\Dbrain
Выполните команду docker-compose up -d --force-recreateи дождитесь завершения запуска всех контейнеров

Всё готово!

Теперь вы можете использовать локальную версию веб-демо, открыв в браузере ссылку http://localhost:8080.

Вы также можете обращаться к локальной версии Dbrain с помощью API. Для этого:

Положите изображение паспорта или другого типового документа в папку Dbrain.
В PowerShell выполните команду curl -X POST "http://localhost:12345/recognize?doc_type=passport_main&quality=75&dpi=300&auto_pdf_raw_images=true&pdf_raw_images=true&token=ваш_ключ_лицензии" -H "accept: application/json" -H "Content-Type: multipart/form-data" -F "image=@C:\Dbrain\Pasport_RF.jpg;type=image/jpeg"

PreviousПодключение к облаку NextМобильный SDK

Last updated 2 years ago