Инструкция по обновлению Monq до версии 8.3.1

Требования

Предыдущая версия Monq: 8.3.0

В обновлении:

Продукт	Новая версия
pl	8.3.1
sm	8.3.1
cl	8.3.1
fm	8.3.1
plugins	8.3.1
mcs	8.3.1

Уровень простоя

Без простоя

Проведение миграции 8.3.0 -> 8.3.1

Требования

Для запуска обновления требуется скачать клиент управления Monq monqctl и выполнить конфигурацию контекста monqctl, если ранее этого не выполнялось.

!!! MonqCtl !!!

Минимальная версия monqctl: 1.15.0

Примечание

Токен доступа в Monq ReleaseHub для скачивания обновления можно взять из письма о регистрации лицензии или получить, обратившись в техническую поддержку Monq.

Выполнить предрелизную подготовку

1. Проверить контекст monqctl и статус реестра микросервисов

   # Просмотреть текущий контекст, с которым работает monqctl
   monqctl config current-context
   
   # Просмотреть статус реестра микросервисов из контекста
   monqctl registry get status
   
   # Просмотреть статус сервисов в реестре микросервисов из контекста
   monqctl registry get services

2. Установить контекст релиза, с которым будет работать monqctl в рамках контекста установленного Monq

   Команда при этом скачивает и подготавливает релиз для установки.

monqctl release use-version 8.3.1 --product=monq

При обновлении из папки

# Требуется выполнить экспорт релиза в папку
monqctl release version export 8.3.1 --product=monq --dest=<export directory>

# Выполнить команду `use-version` с аргументом `--sourceDir`.
monqctl release use-version 8.3.1 --product=monq --sourceDir=<папка с экспортированным обновлением>

---

MONQ Platform (pl)

Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра MONQ

monqctl release update images --module=pl

Выполнить конфигурацию баз данных микросервисов

monqctl release update db pgsql --module=pl --microservice=pl-content-installer-service --file sqls/pl-content-installer-service.sql
monqctl release update db pgsql --module=pl --microservice=pl-userspace-admins-service --file sqls/pl-userspace-admins-service.sql
monqctl release update db pgsql --module=pl --microservice=pl-automaton-v2-service --file sqls/pl-automaton-v2-service.sql
monqctl release update db pgsql --module=pl --microservice=pl-identity-service --file sqls/pl-identity-service.sql

Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes

monqctl release update microservices --module=pl

Выполнить удаление устаревших ключей маршрутизации

monqctl instance delete queue-binding --queue=pl_identity_service --bindingKey=userspace.delete
monqctl instance delete queue-binding --queue=pl_router_service --bindingKey=config-item.create
monqctl instance delete queue-binding --queue=pl_router_service --bindingKey=config-item.delete

---

MONQ Service Monitor (sm)

Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра MONQ

monqctl release update images --module=sm

Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes

monqctl release update microservices --module=sm

---

MONQ Collector (cl)

Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра MONQ

monqctl release update images --module=cl

Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes

monqctl release update microservices --module=cl

---

Test Forge (fm)

Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра MONQ

monqctl release update images --module=fm

Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes

monqctl release update microservices --module=fm

---

MONQ Metrics (mcs)

Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра MONQ

monqctl release update images --module=mcs

Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes

monqctl release update microservices --module=mcs

---

PLUGINS (plugins)

Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра MONQ

monqctl release update images --module=plugins

Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes

monqctl release update microservices --module=plugins

Применить новую маршрутизацию

monqctl release update routing --module=pl
monqctl release update routing --module=cl
monqctl release update routing --module=sm
monqctl release update routing --module=fm
monqctl release update routing --module=mcs
monqctl release update routing --module=plugins
monqctl release update routing --module=sm --file=monq.json