Обновление

примечание

В данном разделе описан гайд по миграции на версию 3.0.0

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

Развертывание Liquibase на репозитарную БД консоли GRDL.
Развертывание консоли GRDL.
Развертывание UI.
Развертывание воркеров.

примечание

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

Пример некорректной конфигурации
Балансировщик стоит между UI и двумя плечами с консолью GRDL. Тогда при обновлении UI и первого плеча с консолью GRDL автоматически нарушается порядок обновления на втором плече с консолью GRDL.

Пример корректной конфигурации
Балансировщик стоит между пользователем и двумя плечами с UI и консолью GRDL. Тогда при обновлении любого из плечей нет воздействия на другое плечо.

Сценарий обновления консоли GRDL

Проверка готовности БД GRDL к обновлению

подсказка

При установке компонента GRDL с нуля, воспользуйтесь Руководством по установке.

Существует пользователь (роль) и схема gdl в БД модуля управления и ему выданы необходимые права
Созданы tablespace grdl_ts_data и grdl_ts_idx

Шаги обновления

Запустите сценарий (playbook) DB_UPDATE перед установкой консоли, для обновления БД консоли.
Удалите конфигурационные файлы k8s GraDeLy. Для этого выполните развертывание через cd пайплайн.

Для подсистем SUBSYSTEM: GRDL_CONSOLE_FULL:
1. Выберите версию дистрибутива DISTRIB_VERSION: <Предыдущая версия дистрибутива>.
2. Выберите список сценариев для установки дистрибутива:
```
 MIGRATION_FP_CONF;
 FP_CONF_CHECK;
 KUBERNETES_PURGE_PROJECT
```
подсказка
Если сценарий KUBERNETES_PURGE_PROJECT недоступен для cd пайплайна, удалите объекты k8s, принадлежащие компоненту GraDeLy, вручную.
Разверните новую версию GraDeLy через cd пайплайн.

Для подсистем SUBSYSTEM: GRDL_CONSOLE_FULL:
1. Выберите версию дистрибутива DISTRIB_VERSION: <Новая версия дистрибутива>.
2. Выберите список сценариев для установки дистрибутива:
```
 DB_UPDATE
 MIGRATION_FP_CONF;
 FP_CONF_CHECK;
 OPENSHIFT_DEPLOY
 OPENSHIFT_INGRESS_EGRESS_DEPLOY
```
подсказка
Сценарий DB_UPDATE выполните для подсистем GRDL_CONSOLE. Для GRDL_CONSOLE установите в cd пайплайне значение ключа worker_db_flag: "NO".

Проверка обновления

Проверьте статус приложения при помощи healthcheck (подробнее в разделе «Проверка работоспособности») по завершении обновления.

Сценарий обновления GraDely Worker в K8s середе

Внимание!

Этот сценарий обновления для ситуаций, когда между версиями соблюдается обратная совместимость. GraDeLy гарантирует совместимость версий релизов.

Проверка готовности клиентской БД к обновлению

Выполните шаги раздела Подготовка БД источника и БД приемника для работы с GraDeLy.

Проверка готовности Kafka к обновлению

Выполните шаги раздела Kafka-топики в GraDeLy.

Шаги обновления

Требуется подготовить subsystems.json добавив него новые SUBSYSTEM пример:

Для установки компонента RPLW (module)

  "<RPLW_SUBSYSTEM>": {
    "fpType": "<fpType>",
    "fpi_name": "rplw",
    "nexus_repo": "<nexus_repo>",
    "groupId": "<groupId>",
    "artifactId": "rplw-cfg",
    "versionFilter": "D-*",
    "fpi_name_ose": "rplw",
    "app_name": ["rplw-module"],
    "registryPath": "<registryPath>"
  },

Сделайте back-up базы данных.
Удалите предыдущую версию приложения, чтобы не было одновременно работающих серверов разных релизов (подробнее в разделе «Удаление»).
Выполните шаги из раздела Установка RPLW в DropApp.
примечание
Особенности обновления компонента RPLW с релизов до 2.3.x:
- Если установка RPLW будет производиться в namespace module предыдущих релизов, то перед этим потребуется очистить этот namespace от манифестов предыдущих релизов.
- Если установка RPLW будет производиться в новый namespace то его требуется настроить в соответствии с namespace где был развернут module.
Проверяйте версию дистрибутива вручную через label(version) прикладных подов или через командную строку администратором (например kubectl get pods -l version=D-2.0.0-XXX выведет все поды версии).

Проверка обновления

Сценарий обновления GraDely Worker на VM