Руководство по установке#

Модуль «Сервис ФЛК для Витрины данных» предназначен для интеграции ГИСОГД субъекта Российской Федерации и Витрины данных и выполняет следующие функции:

  • авторизация и аутентификация с использованием безопасного доступа к сервисам ETL (при необходимости);

  • форматно-логический контроль (ФЛК) данных перед отправкой в Витрину данных для обеспечения корректности и соответствия требованиям;

  • передача сведений, документов и материалов из ГИСОГД субъекта РФ в Витрину данных, включая:

    • загрузку системных справочников;

    • создание, обновление и удаление объектов данных;

    • получение информации по результатам загрузки данных в Витрину данных.

Установка#

Для управления процессом развертывания применяется конфигурационный файл docker-compose.yaml.

  1. Убедитесь в наличии модуля. Модуль уже присутствует, если вы получили пакет с дистрибутивами для проекта.

Дистрибутивы содержат:

  • сервис интеграции datalink-int – реализует методы взаимодействия с Витриной данных, включая передачу, обновление и удаление данных, а также получение справочников и скан-копий документов;

  • сервис валидации datalink-val – выполняет проверку корректности данных перед отправкой в Витрину данных согласно XSD-схемам и форматно-логическим правилам;

  • веб-интерфейс диагностики интеграции datalink-front – предоставляет интерфейс для диагностики интеграции и управления процессами передачи данных;

  • datalink-redis – обеспечивает кэширование системных справочников и других часто используемых данных;

  • datalink-msg – обеспечивает асинхронный обмен сообщениями между компонентами системы через брокер сообщений Kafka.

  1. Разверните в docker-cреде контейнер datalink-int.

  2. Разверните в docker-cреде контейнер datalink-val.

  3. Разверните в docker-cреде контейнер datalink-front.

  4. Развернуть в docker-cреде контейнер Redis.

  5. Развернуть в docker-cреде контейнер Kafka.

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

Веб-интерфейс диагностики интеграции datalink-front имеет встроенные инструменты для проведения тестирования, генерации тестовых данных и проверки работоспособности всех функций сервисов интеграции.

Для перехода к инструментам тестирования необходимо ввести в адресную строку браузера URL инструмента запуска тестов, выбрать тест и нажать кнопку «Запустить».

Режимы функционирования#

Система может функционировать в двух режимах – штатном и диагностическом (аварийном).

Основным режимом функционирования системы является штатный режим, при котором обеспечивается круглосуточная работа с перерывами на обслуживание программных средств, размещенных на технических средствах серверов, а также решение всех задач и выполнение всех функций системы.

Аварийный режим функционирования системы – режим отладки (debug) – может быть использован при отказе одного или нескольких компонентов программного и (или) технического обеспечения для диагностики. С целью снижения интенсивности возникновения аварийных ситуаций должны проводится диагностирование и мониторинг системы.

Чтобы сменить уровень логирования в сервисах datalink-int, datalink-val, datalink-front:

  1. Откройте файл .env.

  2. В блоке параметров env найдите параметры с префиксом LOGGING_LEVEL_ROOT.

  3. Поставьте необходимый уровень логирования в значении параметра value: INFO/WARN/ERROR/DEBUG.

Чтобы сменить уровень логирования в сервисе datalink-redis:

  1. Откройте файл configs/redis.conf.

  2. Добавьте параметр loglevel <уровень логирования>.

  3. Поставьте необходимый уровень логирования: debug, verbose, notice, warning, error.

Чтобы сменить уровнь логирования в сервисе datalink-msg:

  1. Откройте файл configs/log4j.properties.

  2. Найдите параметры data.log4j.properties: log4j.logger.kafka=INFO, fileAppender, log4j.logger.kafka.controller=INFO, fileAppender, log4j.logger.org.apache.kafka=INFO, fileAppender.

  3. Поставьте необходимый уровень логирования: DEBUG, INFO, WARN, ERROR, FATAL.