# Обновление Monq 7.8.0

Проведение миграции 7.7.0 -> 7.8.0

Требования

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

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

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

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

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

# Проведение миграции 7.7.0 -> 7.8.0

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

!!! MonqCtl !!!

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

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

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

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

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

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

monqctl registry update registry --version=3.12.0

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

mkdir registry
monqctl registry export registry 3.12.0  --dest=./registry/
cd registry
monqctl registry update registry --version=3.12.0 --sourceDir=./
rm -rf ../registry

# Выполнить обновление шаблонов реестра

monqctl registry get services K8s --output json | jq '.' > registry-k8s-template-backup.json
cat registry-k8s-template-backup.json | jq \
'.JsonConfig.Parameters |= . + [{Name:"%GrpcIngressSnippet%",Value:"grpc_set_header X-Smon-Userspace-Id 1;"}]' > registry-k8s-template.json
monqctl registry apply service K8s --file registry-k8s-template.json

# 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-userspaces-api-service --file userspace-configuration.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
monqctl release update db pgsql --module=pl --microservice=pl-agents-service --file sqls/pl-agents-service.sql
monqctl release update db pgsql --module=pl --microservice=pl-automaton-rules-api-service --file sqls/pl-automaton-rules-api-service.sql
monqctl release update db clickhouse --module=pl --microservice=pl-automaton-v2-service --file sqls/pl-automaton-v2-api-service-clickhouse.sql
monqctl release update db pgsql --module=pl --microservice=pl-automaton-v2-service --file sqls/pl-automaton-v2-api-service.sql

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

monqctl release update microservices --module=pl

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

monqctl instance clear cache --microservice=pl-i18n-service
monqctl instance clear cache --microservice=pl-user-grants-api-service
monqctl instance clear cache --microservice=pl-identity-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

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

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

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

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

monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service-runner

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

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 --microservice=sm-rsm-service

# Провести миграцию для сервиса РСМ

# Выполнить миграцию. Для выполнения миграции потребуется создать временный ingress для доступа к точке запуска миграций сервиса sm-rsm-service. После применения миграции, временный ingress будет удален.
monqctl release update routing --module=sm --file sm-routing-migration.json
monqctl release exec shell --module=sm --file=rsm_migration.sh
# Удалить маршрутизацию для миграции.
monqctl registry delete microservice sm-routing-migration

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

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

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

monqctl release update migrator --module=sm --command="migrate k8s-new-config-item-types --update"

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

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

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

monqctl release update db pgsql --module=fm --microservice=fm-projects-api-service --file sqls/fm-projects-api-service.sql
monqctl release update db clickhouse --module=fm --microservice=fm-projects-api-service --file sqls/fm-projects-api-service-clickhouse.sql

# Удалить очереди для корректного изменения ключей маршрутизации

monqctl instance delete queue fm_builds_parser_service
monqctl instance delete queue fm_builds_buffer_service
monqctl instance delete queue fm_projects_api_service

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

monqctl release update microservices --module=fm

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

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

# 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=k8sTopologySync
monqctl release update agent-plugins --module=plugins --plugin=k8sMetricsDataFlow
monqctl instance restart microservice --microservice=pl-monq-agent

Проведение миграции 7.7.0 -> 7.8.0