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

Требования

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

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

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

Уровень простоя - без значительной деградации.

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

Проведение миграции 7.14.0 -> 7.15.0

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

!!! MonqCtl !!!

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

Примечание: можно настроить 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.15.0 --product=monq

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

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

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

Выполнить обновление реестра микросервисов

monqctl registry update registry --version=3.13.6
# Просмотреть статус реестра микросервисов после обновления.
monqctl registry get status

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

mkdir registry
monqctl registry export registry 3.13.6  --dest=./registry/
cd registry
monqctl registry update registry --version=3.13.6 --sourceDir=./

# Просмотреть статус реестра микросервисов после обновления
monqctl registry get status

rm -rf ../registry

---

MONQ Platform (pl)

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

monqctl release update images --module=pl

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

monqctl release update db pgsql --module=pl --microservice=pl-i18n-service --file pl-i18n-service.sql

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

monqctl release update microservices --module=pl

Сбросить кэш для микросервисов

monqctl instance clear cache --microservice=pl-i18n-service
monqctl instance clear cache --microservice=pl-router-service

---

MONQ Service Monitor (sm)

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

monqctl release update images --module=sm

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

monqctl release update microservices --module=sm
monqctl release update microservices --module=sm --microservice=sm-rsm-mode-api-service --k8s-merge-type=Replace

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

monqctl release update routing --module=sm

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

monqctl instance delete queue-binding --queue=sm_rsm_health_service --bindingKey=health-generator.sync

Удалить конфигурацию Consul устаревшего микросервиса

PRODUCT="monq"
MODULE="sm"
NAMESPACE=$(monqctl registry get services KubeOptions --output=json | jq -r '.JsonConfig.KubeNamespace')

CONSUL_CONNECTION_STRING=$(monqctl registry get services Consul --output json)
CONSUL_HOST=$(echo ${CONSUL_CONNECTION_STRING} | jq -r '.Host')
CONSUL_TOKEN=$(echo ${CONSUL_CONNECTION_STRING} | jq -r '.RootPassword')

curl -X DELETE -s -H "X-Consul-Token: ${CONSUL_TOKEN}" ${CONSUL_HOST}/v1/kv/${NAMESPACE}/${MODULE}/sm-rsm-mode-api-service/appsettings-async.json

---

MONQ Metrics (mcs)

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

monqctl release update images --module=mcs

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

monqctl release update db pgsql --module=mcs --microservice=mcs-thresholds-service --file sqls/mcs-thresholds-service.sql

Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в 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 agent-plugins --module=plugins --plugin=vmwareTopologySync
monqctl instance restart microservice --microservice=pl-monq-agent

Проверить лог запуска системного агента. Вначале лога должны быть загружены все нужные плагины.