Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comboversions
Links98901;19562597
ProductExeReport
VerNamesот 1.4;1.2

 ExeReport поставляется в формате контейнеризированного приложения, которое может быть запущено как в Docker, так и в кластере Kubernetes.

На данной странице представлена инструкция для инсталляции ПО ExeReport в Docker. По вопросам установки ПО ExeReport в кластере Kubernetes необходимо обращаться на портал технической поддержки.

Table of Contents

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

Параметр

Значение

Процессор

Не менее 4 vCPU.

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

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

ОЗУ

Минимум 4 GB RAM

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

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

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

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

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

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

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

  2. Развертывание кластера Kubernetes InfoИнструкция в разработке 

    Для хоста, на котором установлен Docker обязательно должен быть сконфигурирован ip адрес отличный от "127.0.0.1". Данный ip адрес должен быть использован в качестве [host_ip] при выполнении дальнейших пунктов инструкции.

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

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

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

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

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

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

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

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

Установка ExeReport

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

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

для ОС семейства Linux

Excerpt

Сначала необходимо скопировать в каталог /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'
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'
Expand
titleНастройка подключения к ExeMES
Note

Доступно начиная с версии ExeReport 1.4

Info

Для гибкой настройки параметров отчетов возможно использовать web API ExeMES.

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

Code Block
-e MiddlewareApiRootUri='https://middleware.mycompany.local/api'

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

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

Доступно начиная с версии ExeReport 1.4

Info

Время жизни отчета - это значение в секундах, по истечении которого отчет будет удален из внутренней памяти контейнера приложения. По-умолчанию эта настройка = 60 секундам. Минимальное возможное значение 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 сервером.