Установка

В данном руководстве описываются аспекты Platform V GraDeLy, связанные с установкой системы.

Состав дистрибутива

Platform V GraDeLy поставляется дистрибутивом в виде архива GDL-X.X.X-XXX-distrib.zip.

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

gdl-doc-X.X.X-XXX-distrib.zip — архив с технической документацией на Platform V GraDeLy;
gdl-X.X.X-XXX-owned-distrib.zip — архив с релизом Platform V GraDeLy, содержащий:
- grdl-bin-D-X.X.X-XXX-cyclonedx-distrib.json — файл с информацией о зависимостях артефакта grdl-bin-D-X.X.X-XXX-distrib.zip;
- grdl-bin-D-X.X.X-XXX-distrib.zip — архив, содержащий каталог с бинарными файлами и файлами сбора Docker-образов:
  - ./package/ — каталог дистрибутива;
    - ./db/ — каталог архивов со скриптами liquibase для развертывания необходимых объектов в БД;
    - ./bh/grdl-console.jar — сервис API для взаимодействия с PL (АРМ компонента Базовый модуль (GRDL));
    - ./pl/grdl-console-ui.zip — архив, содержащий файлы Presentation Layer приложения;
    - ./docker/grdl-console/Dockerfile — инструкции по созданию образа;
    - ./docker/grdl-console-ui/Dockerfile — инструкции по созданию образа;
  - regid.2022-12.ru.sbertech_grdl-D-X.X.X.swidtag — файл swidtag с информацией об артефакте grdl-bin-D-X.X.X-XXX-distrib.zip;
- grdl-cfg-D-X.X.X-XXX-distrib.zip — архив, содержащий каталог с конфигурационными файлами установки в k8s:
  - ./package/ — каталог дистрибутива;
    - ./conf/ — каталог с конфигурационными файлами для автоматизированной установки ПО средствами Pipeline;
- regid.2022-12.ru.sbertech_grdl-D-X.X.X.swidtag — файл swidtag с информацией об артефакте grdl-cfg-D-X.X.X-XXX-distrib.zip;
- grdl-bin-D-X.X.X-XXX.pom — файл с информацией об артефакте grdl-bin-D-X.X.X-XXX-distrib.zip;
- grdl-cfg-D-X.X.X-XXX.pom — файл с информацией об артефакте grdl-cfg-D-X.X.X-XXX-distrib.zip;
- rplw-bin-D-X.X.X-XXX-cyclonedx-distrib.json — файл с информацией о зависимостях артефакта rplw-bin-D-X.X.X-XXX-distrib.zip;
- rplw-bin-D-X.X.X-XXX-distrib.zip — архив, содержащий каталог с бинарными файлами и файлами сбора Docker-образов:
  - ./package/ — каталог дистрибутива;
    - ./db/ — каталог архивов со скриптами liquibase для развертывания необходимых объектов в БД;
    - ./bh/gdl-worker.jar — REST-сервис, с которым взаимодействует клиентский модуль GraDeLy;
    - ./docker/rplw-module/Dockerfile — инструкции по созданию образа;
  - regid.2022-12.ru.sbertech_rplw-D-X.X.X.swidtag — файл swidtag с информацией об артефакте rplw-bin-D-X.X.X-XXX-distrib.zip;
- rplw-cfg-D-X.X.X-XXX-distrib.zip — архив, содержащий каталог с конфигурационными файлами установки в k8s:
  - ./package/ — каталог дистрибутива;
    - ./conf/ — каталог с конфигурационными файлами для автоматизированной установки ПО средствами Pipeline;
      - ./ansible/ — каталог с конфигурацией Ansible;
        
        ./common/ — каталог с общей конфигурацией для всех ролей Ansible;
        
        ./gradely_install/ — каталог с конфигурацией роли Ansible для установки ПО;
        
        ./gradely_install_dot/ — каталог с конфигурацией роли Ansible для установки ПО средствами Pipeline;
        
        ./gradely_update/ — каталог с конфигурацией роли Ansible для обновления ПО;
        
        ./gradely_get_version/ — каталог с конфигурацией роли Ansible для получения версии ПО;
- regid.2022-12.ru.sbertech_rplw-D-X.X.X.swidtag — файл swidtag с информацией об артефакте rplw-cfg-D-X.X.X-XXX-distrib.zip;
- rplw-bin-D-X.X.X-XXX.pom — файл с информацией об артефакте rplw-bin-D-X.X.X-XXX-distrib.zip;
- rplw-cfg-D-X.X.X-XXX.pom — файл с информацией об артефакте rplw-cfg-D-X.X.X-XXX-distrib.zip;
- hash-trace.json — файл с хешами grdl-cfg-D-X.X.X-XXX-distrib.zip, grdl-bin-D-X.X.X-XXX-distrib.zip, rplw-bin-D-X.X.X-XXX-distrib.zip, rplw-cfg-D-X.X.X-XXX-distrib.zip и информацией о delivery_tools, использовавшихся для сборки дистрибутива;
- regid.2022-12.ru.sbertech_grdl-D-X.X.X-XXX.swidtag — файл swidtag с информацией об артефакте GDL-X.X.X-XXX-owned-distrib.zip;
- Report.json — файл с отчетом по opensource-зависимостям и хеши библиотек из дистрибутива GDL-X.X.X-XXX-party-distrib.zip;
GDL-X.X.X-XXX-party-distrib.zip — архив с opensource-зависимостями Platform V GraDeLy;
GDL-X.X.X-XXX-owned-distrib.pom — файл с информацией об артефакте GDL-X.X.X-XXX-owned-distrib.zip;
GDL-X.X.X-XXX-party-distrib.pom — файл с информацией об артефакте GDL-X.X.X-XXX-party-distrib.zip;
GDL-X.X.X-XXX-cyclonedx-distrib.json — файл с информацией о зависимостях артефакта GDL-X.X.X-XXX-distrib.zip;
regid.2022-12.ru.sbertech_GDL-X.X.X-XXX.swidtag — файл swidtag с информацией об артефакте GDL-X.X.X-XXX-distrib.zip.

примечание

X.X.X-XXX — версия релиза.

Порядок установки

Выбор способа установки

Для GraDeLy предусмотрена автоматизированная установка через компонент Deploy tools продукта Platform V DevOps Tools (DOT).

Сертификаты для компонента не устанавливаются, данные потребителей не шифруются, а кодируются в message pack. Ролевая модель не настраивается.

GraDeLy поддерживает три режима установки:

Установка без дополнительных интеграций (режим simplified) — базовая установка с минимальным набором компонентов;
Установка в режиме MTLS (режим MTLS) — установка с минимальным набором компонентов и поддержкой MTLS и использованием service mesh;
Установка с дополнительными интеграциями (режим enterprise) — полная установка с интеграцией с Istio, OTT, Kafka, Vault и другими сервисами.

Этапы установки

Подготовка базы данных

Развернуть PostgreSQL.
Создать tablespace grdl_ts_data и grdl_ts_idx.
Создать пользователя и схему gdl в БД модуля управления.
Создать пользователя с правом репликации в БД источника и приемника.

Развертывание объектов БД

После подготовки БД, в БД конфигурации необходимо развернуть объекты базы данных с использованием liquibase. Подробные инструкции см. в разделах:

Установка консоли GRDL