Установка WLDT#

Цель выполнения#

Целью данной инструкции «Установка WLDT» является описание последовательных шагов по развертыванию компонента WLDT. Выполнение инструкции обеспечивает корректную установку и настройку сервисов «frontend» и «modeler», включая сборку и публикацию контейнерных образов, а также развертывание компонентов с помощью Helm-чарта.

Состав дистрибутива компонента WLDT#

Перед установкой убедитесь, что состав дистрибутива компонента WLDT корректен и представлен в полном объеме.

Компонент WLDT предоставляет 2 архива (бинарные файлы и конфигурации), а также дополнительные файлы:

wldt-bin-{version}-{build}-distrib#

Элемент дистрибутива

Описание

./package/bh/frontend

Бинарные файлы приложения «frontend»

./package/bh/modeler

Бинарные файлы приложения «modeler»

./package/docker/frontend/Dockerfile

Dockerfile для сборки приложения «frontend»

./package/docker/modeler/Dockerfile

Dockerfile для сборки приложения «modeler»

wldt-cfg-{version}-{build}-distrib#

Конфигурации для установки.

Элемент дистрибутива

Описание

./package/conf/helm/application/wldt/*

Конфигурации развертывавния компонента

wldt-bin-{version}-{build}–cyclonedx-distrib.json#

В данном файле находится спецификация программного обеспечения SBOM (Software Bill Of Materials) — это список всех open source и других сторонних компонент, использующихся в кодовой базе программного продукта.

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

С помощью SBOM вы можете просмотреть версии сборки, номера выпусков компонентов программного обеспечения и решить, продолжать их использование или нет. Это необходимо во избежание проблем с безопасностью в цепочках зависимостей. Поэтому, если в одной из библиотек обнаруживается проблема, вам необходимо знать, уязвимо ли приложение в целом.

CycloneDX — это стандарт SBOM от фонда OWASP, разработанный для контекстов безопасности приложений и анализа компонентов цепочки поставок, обеспечивающий инвентаризацию всех компонентов программного обеспечения как собственных, так и сторонних производителей.

Последовательность действий#

  1. Шаг 1. Сборка и установка бинарных файлов

  2. Шаг 2. Развертывание сервиса c помощью Helm чарта

Примечание: в виду отсутствия ролевой модели для компонента WLDT отсутсвует необходимость в ее установке соотвественно.

Шаг 1. Сборка и установка бинарных файлов#

Цель выполнения#

Цель выполнения шага - подготовить бинарные файлы приложения, собрать их в контейнерный образ (image) и интегрировать его в конфигурации установки, чтобы обеспечить корректную работу системы.

Последовательность действий#

  1. Используйте инструменты сборки, чтобы создать исполняемые файлы или артефакты.

  2. Соберите Docker-образ, включающий бинарные файлы.

Чтобы собрать Docker-образ для frontend введите следующую команду:

   docker build -t <ваш registry>/<ваш путь>/frontend:latest -f package/docker/frontend/Dockerfile . --build-arg=<базовый образ>

Далее отправьте Docker-образ для frontend в registry, для этого введите следующую команду:

   docker push <ваш registry>/<ваш путь>/frontend:latest

Чтобы собрать Docker-образ для modeler введите следующую команду:

   docker build -t <ваш registry>/<ваш путь>/modeler:latest -f package/docker/modeler/Dockerfile . --build-arg=<базовый образ>

Далее отправьте Docker-образ для modeler в registry, для этого введите следующую команду:

   docker push <ваш registry>/<ваш путь>/modeler:latest

  1. Обновите конфигурационные файлы (например, Helm-chart, Kubernetes Deployment), указав новый образ:

image:
  repository: <ваш registry>/<имя вашего образа>
  tag: latest

Проверка результата#

Если все выполнено верно, система будет использовать актуальный образ с собранными бинарными файлами, и конфигурации установки будут работать без ошибок.

Шаг 2. Развертывание сервисов c помощью Helm чарта#

Цель выполнения#

Цель выполнения шага - развернуть сервисы с использованием Helm-чарта, используя подготовленный Docker-образ с бинарными файлами, чтобы обеспечить корректную работу системы в кластере Kubernetes.

Последовательность действий#

  1. Убедитесь, что Helm-чарт существует и содержит конфигурации для развертывания сервисов.

  2. Выполните команду для установки чарта в кластер Kubernetes:

   helm install <ваш релиз> ./path/to/chart --namespace <название вашего namespace>

Проверка результата#

Если все выполнено верно:

  • Helm-релиз будет отображаться в списке (helm list).

  • Все поды будут работать без ошибок.

Проверка результата#

Корректным результатом проверки установки WLDT является соотвествие успешным проверкам в шагах:

  • Сборка и установка бинарных файлов.

  • Развертывание сервисов c помощью Helm чарта.