Versions Compared

Old Version 7

changes.mady.by.user Eduard Zhitenev

Saved on

compared with

New Version 8

changes.mady.by.user Victoria Belyaeva

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Восстановить из v. 6
 ExeReport поставляется в формате контейнеризированного приложения, которое может быть запущено как в Docker, так и в кластере Kubernetes.

Table of Contents

Expand
titleМинимальные системные требования

Параметр

Значение

Процессор

Не менее 4 vCPU.

Частота – не ниже 2,6 ГГц.

Поддерживает работу с 64-разрядными приложениями на аппаратном уровне.

ОЗУ

Минимум 4 GB RAM

Свободное пространство на жестком диске

Объем – не менее 50 Гб.

Примечание: объем необходимого свободного места на жестком диске зависит от количества отчетов, хранящихся в ExeReport, и определяется самостоятельно на основе опытной эксплуатации ПО.

Подготовка к установке

  1. Подготовка среды для развертывания приложения (среда на выбор):

    1. Установка Docker
      Expand
      titleИнструкция по установке

      Include Page
      Установка Docker
      Установка Docker

    2. Развертывание кластера Kubernetes
      Info

      Инструкция в разработке 

  2. Подготовка сертификатов 

    Expand
    titleИнструкция

    Include Page
    Подготовка сертификатов
    Подготовка сертификатов

  3. Настройка DNS
    Expand
    titleИнструкция

    Include Page
    Настройка DNS
    Настройка DNS

  4. Установка Guardant Control Center и Guardant SLK

    Expand
    titleИнструкция

    Include Page
    Установка Guardant Control Center и Guardant SLK
    Установка Guardant Control Center и Guardant SLK

Установка ExeReport

  • Установка ExeReport в Docker

    Excerpt
    Expand
    titleИнструкция по установке в Debian

    Сначала необходимо скопировать в каталог /root/dev/crt полученные на предыдущих шагах сертификаты. Далее необходимо в терминале ОС перейти в каталог /root/dev и выполнить команду:

    Code Block
    ./install-exereport.sh

    при этом произойдет загрузка образов, копирование данных и запуск сервисов.

    Note

    Если файл не запускается, измените права на этот файл командой:

    Code Block
    chmod +x install-exereport.sh

  • Установка ExeReport в Kubernetes

    Info

    Инструкция в разработке

Настройка переменных окружения

Info

Переменные окружения - набор значений, который определяет необходимые параметры работы и запуска приложений

Пакет инсталляции ExeReport уже содержит настроенные переменные окружения и если вы не планируете менять настройки по умолчанию, то можете пропустить данный шаг.

Доступные настройки::

Expand
titleНастройка подключения к БД

При запуске контейнера необходимо передать в переменной окружения DBConnection строку подключения к БД приложения ExeReport. Пример:

Code Block
docker run [путь для скачивания образа приложения] -e DBConnection='Host=localhost;Port=5432;Database=exereport;Username=postgres;Password=postgres'

Настройка переменной окружения DBConnection  также может быть выполненна путем редактирования файла docker-compose.yaml. Пример:

Code Block
DBConnection: "Server=localhost;UserId=postgres;Database=exereport;Port=5432;Password=postgres;SSLMode=Prefer"
Expand
titleРазрешение CORS
Info

CORS (Cross-Origin Resource Sharing) — это механизм браузера, который позволяет определить список ресурсов, к которым страница может получить доступ.

Он необходим для обеспечения безопасности и защиты пользователей от злоумышленников при использовании HTTP-протокола.

По умолчанию сайты могут запрашивать ресурсы только со своего origin. Такое ограничение называется Same-Origin Policy. CORS расширяет Same-Origin Policy, позволяя получать доступ к ресурсам с разных доменов.

Разрешения CORS могут потребоваться, если вы вызываете методы ExeReport  в сторонних приложениях: внешних пользовательских портала, таких как ELMA365 и прочие.

 Для разрешения CORS необходимо передать переменную окружения AllowedCORSUrls, в которой через запятую перечислить разрешенные сайты. Пример:

Code Block
-e AllowedCORSUrls='https://elma365.exeplant.local,https://portal.exeplant.local'

Настройка переменной окружения DBConnection  также может быть выполненна путем редактирования файла docker-compose.yaml. Пример:

Code Block
AllowedCORSUrls: "https://elma365.exeplant.local,https://portal.exeplant.local"
Expand
titleПодключение к ExeMES Middleware
Info

В случае совместного использования ПО ExeMES и ExeReport необходимо сконфигурировать переменную окружения для доступа ExeReport к серверу ExeMES Middleware.

 Для подключения ExeReport к ExeMES Middleware необходимо передать переменную окружения

MiddlewareApiRootUri, в которой указать ссылку на запущенное приложение ExeMES Middleware. Пример:
Code Block
-e MiddlewareApiRootUri='https://middleware.mycompany.local/api'

Настройка переменной окружения DBConnection  также может быть выполненна путем редактирования файла docker-compose.yaml. Пример:

Code Block
MiddlewareApiRootUri: "https://middleware.mycompany.local/api"
Expand
titleНастройка управления временем жизни отчёта
Info

Время жизни отчета - это значение в секундах, по истечении которого отчет будет удален из внутренней памяти контейнера. По-умолчанию эта настройка = 60 (1 мин.) Минимальное значение 10 секунд. Максимальное значение 1200 секунд.

 Для настройки времени жизни отчета необходимо передать переменную окружения WebReportLifeTimeInterval, в которой значение в секундах. Пример:

Code Block
-e WebReportLifeTimeInterval='600'

Настройка переменной окружения WebReportLifeTimeInterval также может быть выполненна путем редактирования файла docker-compose.yaml. Пример:

Code Block
WebReportLifeTimeInterval: "600"

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

Проверить, что сервисы запустились, можно перейдя в браузере по адресу, указанному при установке: https:// [ip хоста, на который устанавливался ExeReport]/.

В случае корректной установки ПО ExeReport в браузере должно открыться окно авторизации ExeReport

Warning

В настройках контейнеров ExeReport по умолчанию указана синхронизация времени контейнера с временем хоста, на котором он запущен. Рекомендуется синхронизировать локальное время хостов, на которых запускаются контейнеры ExeReport с корпоративном ntp сервером.