Обновление Системы

Для обновления Системы необходимо выполнить следующие действия:

1. Использовать namespace, созданный при установке Платформы в пространстве Ku-bernetes.

2. Обновить репозиторий:

helm repo update

3. Показать список доступных версий командой:

helm search repo ldm --versions

4. Найти нужную версию:

helm search repo ldm --versions | grep 1.11.1

5. Создать директорию для удобства сохранения и распаковки.

6. Скачать в созданную директорию образы:

helm pull ldm/bpms --version 1.11.1

7. Распаковать командой:

tar xvzf bpms-1.11.1.tgz

8. После распаковки открыть файл «values.yaml» и внести изменения.

Пример «values.yaml» лежит в директории «kubernetes/values.yaml», также в директории доступен helm chart.

  • В блоке «default» найти строку «pullSecrets», удалить квадратные скобки и через «- name:» добавить ранее созданный секрет в формате «ключ: значение».

img

Процесс создания секрета и перечень используемых для этого команд представлены в документе «Руководство по установке и конфигурированию ЛДМ. Платформа контент-сервисов».

  • В строке «repository» указать внешний репозиторий «nexus.ldm.ru:8081».
  • Для ingress указать свой host, на котором разворачивается инфраструктура.

img

  • Заменить все IP-адреса (192.168.1.45), встречающиеся в файле, на IP-адреса хоста, на котором разворачивается инфраструктура.

  • Получить сгенерированный секретный ключ командой::

kubectl get secrets

Скопировать наименование ключа из колонки «NAME» и вставить его в строку «secretName» для tls.

img

  • Заменить ENVIRONMENT_PREFIX и все вхождения «demo» на те префиксы, которые будут использоваться в микросервисах.

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

  • Заменить все порты «9200» в файле, в частности «ELASTICSEARCH_PORT: 9200», на свои.

  • Для сервисов dh-processes-service, dh-tasks-service, ldm-operate-service, ldm-rest-connector-standalone-service заменить ZEEBE_HOST на значение, соответствующее наименованию установленного Zeebe.

Точное наименование можно получить из списка командой при условии, что ранее Zeebe был успешно установлен:

kubectl get svc
  • Заменить все Keycloak ключи для клиентов dh-backend, dh-webclient на свои.

Для получения Keycloak ключей необходимо авторизоваться в Keycloak, перейти в реалм DH, открыть раздел Client. Открыть карточку клиента, перейти на вкладку Credentials, скопировать ключ в строке «Secret».

img

Повторить эти действия для каждого клиента – dh-backend, dh-webclient.

В файле «values.yaml» для dh-backend значения переменной «KEYCLOAK_CLIENT_SECRET» заменить на ключ, полученный в карточке клиента dh-backend, для всех микросервисов. После замены с помощью поиска убедиться, что прежнее значение в файле больше не встречается.

Для dh-webclient значения переменной «KEYCLOAK_WEBCLIENT_SECRET» заменить на ключ, полученный в карточке клиента dh-webclient, для всех микросервисов. После замены с помощью поиска убедиться, что прежнее значение в файле больше не встречается.

9. Находясь в директории Системы, произвести обновление:

helm upgrade bpms ldm/bpms --version 1.11.1 -f values.yaml

10. Проверить наличие Системы в списке установленных релизов текущего кластера:

helm list

Для обновленной Системы изменится значение «Revision» и версия чарта.

11. Вывести список сервисов для отслеживания их состояния:

kubectl get pods | grep 0/1