Перейти к основному содержимому

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

Требования

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

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

ПродуктНовая версия
pl8.2.2
sm8.2.2
cl8.2.2
fm8.2.2
plugins8.2.0
mcs8.2.2

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

Без простоя

Проведение миграции 8.2.1 -> 8.2.2​

Требования​

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

!!! MonqCtl !!!

Минимальная версия monqctl: 1.13.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.2.2 --product=monq
При обновлении из папки
# Требуется выполнить экспорт релиза в папку
monqctl release version export 8.2.2 --product=monq --dest=<export directory>

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

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-bp-service --file sqls/pl-bp-service.sql
monqctl release update db clickhouse --module=pl --microservice=pl-bp-service --file sqls/pl-bp-service-clickhouse.sql

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

monqctl release update microservices --module=pl

Обновить существующие и установить новые библиотеки автоматона​

monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.core.import
warning

При ошибке HTTP 500 и сообщении в теле ответа "Operation timeout exception" повторить команды. Такая ошибка может возникнуть, если микросервис "pl-automaton-v2-service" не успел перезапуститься после обновления контейнера.

Перезапустить микросервисы автоматон 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 migrator --module=pl --command="migrate userspaces"

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

monqctl release update routing --module=pl

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

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

MONQ Service Monitor (sm)​

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

monqctl release update images --module=sm

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

monqctl release update microservices --module=sm

MONQ Collector (cl)​

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

monqctl release update microservices --module=cl

Запустить мигратор​

monqctl release update migrator --module=cl --command="migrate stream-agent-tasks"

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

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

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

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

monqctl release update microservices --module=mcs

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

monqctl release update routing --module=mcs

Перезапустить микросервисы автоматон v2​

monqctl instance restart microservice --microservice=mcs-thresholds-service
monqctl instance restart microservice --microservice=mcs-thresholds-service-runner