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

Требования

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

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

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

Уровень простоя - без простоя.

Релиз включает обновление различных модулей Monq. Если установлен только определенный набор модулей, например: pl и cl, то разделы с остальными модулями можно проигнорировать.

Проведение миграции 7.8.2 -> 7.8.3

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

!!! MonqCtl !!!

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

Примечание: можно настроить 2 контекста для stage и production одновременно.

Примечание 2: токен для доступа в 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 7.8.3 --product=monq

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

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

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

---

Monq Service Monitor (sm)

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

monqctl release update images --module=sm

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

monqctl release update db arangodb --module=sm --microservice=sm-rsm-service --file sqls/sm-rsm-service.aql

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

monqctl instance delete queue-binding --queue=sm_rsm_service --bindingKey=sm.attribute.create
monqctl instance delete queue-binding --queue=sm_rsm_service --bindingKey=sm.attribute.update
monqctl instance delete queue-binding --queue=sm_rsm_service --bindingKey=sm.attribute.delete

monqctl instance delete queue-binding --queue=sm_sla_service --bindingKey=tag.add
monqctl instance delete queue-binding --queue=sm_sla_service --bindingKey=tag.remove

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

monqctl release update microservices --module=sm