Инструкция по обновлению Monq до версии 7.14.0
Предыдущая версия Monq: 7.13.3
В обновлении:
Продукт | Новая версия |
---|---|
pl | 7.14.0 |
sm | 7.14.0 |
cl | 7.14.0 |
fm | 7.14.0 |
plugins | 7.14.0 |
mcs | 7.14.0 |
Уровень простоя - без значительной деградации.
Релиз включает обновление различных модулей Monq. Если установлен только определенный набор модулей, например: pl и cl, то разделы с остальными модулями можно проигнорировать.
Проведение миграции 7.13.3 -> 7.14.0
Для запуска обновления требуется скачать клиент управления Monq monqctl и выполнить конфигурацию контекста monqctl, если ранее этого не выполнялось.
Минимальная версия monqctl: 1.12.0
Примечание: можно настроить 2 контекста для stage и production одновременно.
Примечание 2: токен для доступа в Monq ReleaseHub для скачивания обновления требуется получить, обратившись в поддержку Monq, либо из письма с регистрацией лицензии.
Выполнить предрелизную подготовку
-
Проверить контекст monqctl и статус реестра микросервисов.
# Просмотреть текущий контекст, с которым работает monqctl.
monqctl config current-context
# Просмотреть статус реестра микросервисов и з контекста.
monqctl registry get status
# Просмотреть статус сервисов в реестре микросервисов из контекста.
monqctl registry get services -
Установить контекст релиза, с которым будет работать monqctl в рамках контекста установленного Monq. Команда при этом скачивает и подготавливает релиз.
monqctl release use-version 7.14.0 --product=monq
# Требуется выполнить экспорт релиза в папку
monqctl release version export 7.14.0 --product=monq --dest=<export directory>
# Выполнить команду `use-version` с аргументом `--sourceDir`.
monqctl release use-version 7.14.0 --product=monq --sourceDir=<папка с экспортированным обновлением>
Выполнить обновление реестра микросервисов
monqctl registry update registry --version=3.13.5
# Просмотреть статус реестра микросервисов после обновления.
monqctl registry get status
mkdir registry
monqctl registry export registry 3.13.5 --dest=./registry/
cd registry
monqctl registry update registry --version=3.13.5 --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
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
monqctl release update db pgsql --module=pl --microservice=pl-user-grants-api-service --file sqls/pl-user-grants-api-service.sql
Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes
monqctl release update microservices --module=pl
Сбросить кэш для микросервисов
monqctl instance clear cache --microservice=pl-i18n-service
Обновить существующие и установить новые библиотеки автоматона
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.cmdb.import
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.metrics.import
При ошибке HTTP 500 и сообщении в теле ответа "Operation timeout exception" повторить команды. Такая ошибка может возникнуть, если микросервис не успел перезапуститься при обновлении.
Перезапустить микросервисы автоматон v2
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service-runner
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service-compiler
Применить новую маршрутизацию
monqctl release update routing --module=pl
MONQ Service Monitor (sm)
Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра MONQ
monqctl release update images --module=sm
Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes
monqctl release update microservices --module=sm
Выполнить конфигурацию баз данных микросервисов
monqctl release update db clickhouse --module=sm --microservice=sm-rsm-coverage-service --file sqls/sm-rsm-coverage-service-clickhouse.sql
Запустить мигратор
monqctl release update migrator --module=sm --command="migrate config-items-extended-info"
Применить новую маршрутизацию
monqctl release update routing --module=sm