Инструкция по обновлению Monq до версии 8.0.0
Предыдущая версия Monq: 7.15.0
-
Перед обновлением до версии Monq 8.0.0 обратитесь в техническую поддержку для получения нового активационного ключа.
-
Все существующие личные Карты РСМ будут безвозвратно удалены из системы. Для сохранения данных карт, пользователям нужно сделать эти карты групповыми выбрав для них любую доступную РГ.
-
Все личные шаблоны отчетов Доступности из системы будут удалены. Для сохранения своих личных шаблонов в системе необходимо сделать его групповым выбрав для них любую доступную РГ.
-
Будут перенесены только системные роли Администраторов пространства. Все прочие роли будут безвозвратно удалены из системы. Администраторы с пользовательскими ролями будут мигрированы с ролью "Администратор пространства", обладающей правами на всё. После обновления, при необходимости, этих пользователей нужно будет ограничить в имеющихся правах, создав для них новую роль.
-
Название предоставляемых прав на КЕ были переименованы:
- с
base-system.rsm.config-items-read
наsm.rsm.config-items-read
- с
base-system.rsm.config-items-write
наsm.rsm.config-items-write
Если в сценариях автоматизации вы использовали предоставление доступа к КЕ - необходимо заменить данные параметры.
- с
-
В сценариях автоматизации и пользовательских функциях будут удалены объекты, использующие структуру
EmailConfiguration
. В ходе обновления в логе мигратора будет выведена информация, какие сценарии и функции были затронуты. Их потребуется адаптировать вручную после обновления. -
В новой версии Monq Agent меняется название плагина
httpPlugin2
наhttpPlugin
(справка). После обновления системы, в Потоках данных могут наблюдаться ошибки, типаPlugin httpPlugin2 not found
. В таком случае необходимо исправить название плагина сhttpPlugin2
наhttpPlugin
в заданиях этих Потоков данных.
В обновлении:
Продукт | Новая версия |
---|---|
pl | 8.0.0 |
sm | 8.0.0 |
cl | 8.0.0 |
fm | 8.0.0 |
plugins | 8.0.0 |
mcs | 8.0.0 |
Уровень простоя
Деградация прав пользователей на период обновления. Возможны сбои в выполнении сценариев автоматона из-за изменения функции проверки прав служебных пользователей.
Проведение миграции 7.15.0 -> 8.0.0
Требования
Для запуска обновления требуется скачать клиент управления Monq monqctl и выполнить конфигурацию контекста monqctl, если ранее этого не выполнялось.
Минимальная версия monqctl: 1.13.0
Токен доступа в Monq ReleaseHub для скачивания обновления можно взять из письма о регистрации лицензии или получить, обратившись в техническую поддержку Monq.
Выполнить предрелизную подготовку
-
Проверить контекст monqctl и статус реестра микросервисов
# Просмотреть текущий контекст, с которым работает monqctl
monqctl config current-context
# Просмотреть статус реестра микросервисов из контекста
monqctl registry get status
# Просмотреть статус сервисов в реестре микросервисов из контекста
monqctl registry get services -
Установить контекст релиза, с которым будет работать
monqctl
в рамках контекста установленного MonqКоманда при этом скачивает и подготавливает релиз для установки.
monqctl release use-version 8.0.0 --product=monq
# Требуется выполнить экспорт релиза в папку
monqctl release version export 8.0.0 --product=monq --dest=<export directory>
# Выполнить команду `use-version` с аргументом `--sourceDir`.
monqctl release use-version 8.0.0 --product=monq --sourceDir=<папка с экспортированным обновлением>
Выполнить обновление реестра микросервисов
monqctl registry update registry --version=3.13.8
# Проверить статус реестра микросервисов после обновления.
monqctl registry get status
mkdir registry
monqctl registry export registry 3.13.8 --dest=./registry/
cd registry
monqctl registry update registry --version=3.13.8 --sourceDir=./
# Проверить статус реестра микросервисов после обновления
# !ВНИМАНИЕ: дождаться, пока `monqctl registry get status` не выдаст в результате версию `Version: "3.13.8"`
monqctl registry get status
rm -rf ../registry
Выполнить обновление шабло нов реестра микросервисов
monqctl registry get services K8s --output json | jq '.' > registry-k8s-template-backup.json
global_domain=$(jq -r '.JsonConfig.Parameters[] | select(.Name=="%GlobalDomain%").Value' registry-k8s-template-backup.json)
jq --arg internal_domain "api.${global_domain}" 'del(.JsonConfig.Parameters[] | select(.Name=="%GlobalDomain%")) | del(.JsonConfig.Parameters[] | select(.Name=="%AliasDomains%")) | del(.JsonConfig.Parameters[] | select(.Name=="%FrontCustomer%")) | .JsonConfig.Parameters |= . + [{Name:"%InternalDomain%",Value:$internal_domain}] | .JsonConfig.routingIngress.metadata.labels."monq/routing-version" = "%AppVersion%"' registry-k8s-template-backup.json > registry-k8s-template.json
monqctl registry apply service K8s --file registry-k8s-template.json
Выполнить обновление маршрутизации
monqctl registry delete microservice pl-routing
monqctl release update routing --module=pl
monqctl registry delete microservice cl-routing
monqctl release update routing --module=cl
monqctl registry delete microservice sm-routing
monqctl release update routing --module=sm
monqctl registry delete microservice fm-routing
monqctl release update routing --module=fm
monqctl registry delete microservice mcs-routing
monqctl release update routing --module=mcs
monqctl registry delete microservice plugins-routing
monqctl release update routing --module=plugins
monqctl release update routing --module=sm --file=monq.json