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

Требования

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

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

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

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

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

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

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

!!! MonqCtl !!!

Минимальная версия monqctl: 1.11.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.9.0 --product=monq

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

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

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

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

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

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

mkdir registry
monqctl registry export registry 3.12.2  --dest=./registry/
cd registry
monqctl registry update registry --version=3.12.2 --sourceDir=./
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-api-service.sql
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-userspaces-api-service --file sqls/pl-userspaces-api-service.sql

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

monqctl release update microservices --module=pl

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

monqctl release update migrator --module=pl --command="migrate automaton"

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

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

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

monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.core.import
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.metrics.import
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.signals.import
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.contribution.import
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.fm.autotests.import
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.notification.import

Если возникла ошибка Error connecting to https://<FQDN>/.well-known/openid-configuration. The SSL connection could not be established - добавить к команде --skip-ssl-verify.

Если возникла ошибка 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

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

monqctl release update db pgsql --module=sm --microservice=sm-rsm-maps-service --file sqls/sm-rsm-maps-service.sql
monqctl release update db pgsql --module=sm --microservice=sm-rsm-mode-api-service --file sqls/sm-rsm-mode-api-service.sql
monqctl release update db pgsql --module=sm --microservice=sm-signals-service --file sqls/sm-signals-service.sql
monqctl release update db arangodb --module=sm --microservice=sm-rsm-service --file sqls/sm-rsm-service.aql
monqctl release update db clickhouse --module=sm --microservice=sm-rsm-health-service --file sqls/sm-rsm-health-service-clickhouse.sql

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

monqctl release update microservices --module=sm

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

monqctl release update migrator --module=sm --command="migrate components"
monqctl release update migrator --module=sm --command="migrate status-rules"
monqctl release update migrator --module=sm --command="migrate signals"
monqctl release update migrator --module=sm --command="migrate rsm-health"

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

monqctl instance delete queue-binding --queue=sm_rsm_mode_api_service --bindingKey=sm.signals.change
monqctl instance delete queue-binding --queue=sm_rsm_mode_api_service --bindingKey=sm.signals.close
monqctl instance delete queue-binding --queue=sm_rsm_mode_api_service --bindingKey=sm.signals.create

monqctl instance delete queue-binding --queue=sm_rsm_health_service --bindingKey=config-item.status-change
monqctl instance delete queue-binding --queue=sm_rsm_health_service --bindingKey=config-item.status-change.health-generator.retry
monqctl instance delete queue-binding --queue=sm_rsm_health_service --bindingKey=config-item.update
monqctl instance delete queue-binding --queue=sm_rsm_health_service --bindingKey=config-item.update.health-generator.retry

monqctl instance delete queue-binding --queue=sm_action_generator_service --bindingKey=sm.signals.proccessed-by.rsm-mode

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

monqctl release update routing --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

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

monqctl release update agent-plugins --module=plugins --plugin=zabbixEventsDataFlow
monqctl release update agent-plugins --module=plugins --plugin=zabbixCheckVersion
monqctl release update agent-plugins --module=plugins --plugin=zabbixCheckConnection
monqctl instance restart microservice --microservice=pl-monq-agent

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

monqctl release update content-packs --module=plugins --replace --file=content-packs/k8s.zip
monqctl release update content-packs --module=plugins --replace --file=content-packs/zabbix.zip

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

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

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

Monq Platform (pl)​

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

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

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

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

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

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

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

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

Monq Service Monitor (sm)​

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

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

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

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

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

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

Monq Collector (cl)​

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

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

Test Forge (fm)​

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

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

Monq Metrics (mcs)​

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

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

PLUGINS (plugins)​

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

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

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

Выполнить загрузку контент-паков​

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

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

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

Monq Platform (pl)

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

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

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

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

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

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

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

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

Monq Service Monitor (sm)

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

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

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

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

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

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

Monq Collector (cl)

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

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

Test Forge (fm)

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

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

Monq Metrics (mcs)

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

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

PLUGINS (plugins)

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

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

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

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