Инструкция по обновлению Monq до версии 9.1.0
В этом обновлении
| Модуль | Новая версия |
|---|---|
| pl | 9.1.0 |
| sm | 9.1.0 |
| cl | 9.1.0 |
| fm | 9.1.0 |
| mcs | 9.1.0 |
| plugins | 9.1.0 |
Уровень простоя
Без простоя
Проведение миграции 9.0.0 → 9.1.0
Требования
Требуемая версия Monq: 9.0.0
Требуемая версия monqctl: 1.18.0
Для запуска обновления требуется скачать клиент управления Monq monqctl и выполнить конфигурацию контекста monqctl, если ранее не выполнялось.
Выполнить предрелизную подготовку
Проверить контекст monqctl и статус реестра микросервисов
# Просмотреть текущий контекст, с которым работает monqctl
monqctl config current-context
# Просмотреть статус реестра микросервисов из контекста
monqctl registry get status
# Просмотреть статус сервисов в реестре микросервисов из контекста
monqctl registry get services
Установить контекст релиза, с которым будет работать monqctl в рамках контекста установленного Monq
Команда при этом скачивает и подготавливает релиз для установки.
monqctl release use-version 9.1.0 --product=monq
Закрытый контур / обновление из папки
На системе с доступом к сети интернет, установленном и настроенном monqctl, выполнить экспорт релиза в папку
monqctl release version export 9.1.0 --product=monq --dest=<export directory>
После переноса папки на сервер выполнить команду с аргументом --sourceDir
monqctl release use-version 9.1.0 --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-system-notify-service --file sqls/pl-system-notify-service.sql
monqctl release update db pgsql --module=pl --microservice=pl-userspaces-api-service --file sqls/pl-userspaces-api-service-1.sql
monqctl release update db pgsql --module=pl --microservice=pl-bp-service --file sqls/pl-bp-service.sql
monqctl release update db pgsql --module=pl --microservice=pl-identity-service --file sqls/pl-identity-service.sql
Запустить миграцию данных
monqctl release update migrator --module=pl --command="migrate bc"
Выполнить конфигурацию баз данных микросервисов
monqctl release update db pgsql --module=pl --microservice=pl-userspaces-api-service --file sqls/pl-userspaces-api-service-2.sql
Выполнить обновление библиотек "автоматон v2"
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.core.import
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.cmdb.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.notification.import
ошибки при выполнении команд
При появлении ошибки необходимо повторить команды, выдержав небольшую паузу.
Такая ошибка может возникнуть если микросервис "pl-automaton-v2-service" не успел перезапуститься после обновления, либо обновление библиотеки уже производится.
При успешном обновлении команда вернет сообщение о том, что библиотека уже обновлена - (has already installed in the System).
Запустить миграцию данных
monqctl release update migrator --module=pl --command="migrate automaton"
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=pl
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
Применить обновление маршрутизации
monqctl release update routing --module=pl
Перезапустить микросервисы "автоматон v2"
monqctl instance restart microservice --microservice=pl-automaton-v2-service
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service-compiler
Перезапустить микросервисы бизнес-процессов
monqctl instance restart microservice --microservice=pl-bp-service-manager
Сбросить кэш для микросервисов
monqctl instance clear cache --microservice=pl-i18n-service
monqctl instance clear cache --microservice=pl-identity-service
monqctl instance clear cache --microservice=pl-userspaces-api-service
Перезапустить микросервис исполнитель сценариев "автоматон v2"
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service-runner
Выполнить удаление устаревших баз данных
monqctl instance delete db postgresql pl_business_calendar_api_service
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
MONQ Service Monitor (sm)
Выполнить импорт контейнеров в репозиторий обновляемого экземпляра Monq
monqctl release update images --module=sm
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=sm
Применить обновление маршрутизации
monqctl release update routing --module=sm
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
MONQ Collector (cl)
Выполнить импорт контейнеров в репозиторий обновляемого экземпляра Monq
monqctl release update images --module=cl
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=cl
Применить обновление маршрутизации
monqctl release update routing --module=cl
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
Test Forge (fm)
Выполнить импорт контейнеров в репозиторий обновляемого экземпляра Monq
monqctl release update images --module=fm
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=fm
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
MONQ Metrics (mcs)
Выполнить импорт контейнеров в репозиторий обновляемого экземпляра Monq
monqctl release update images --module=mcs
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=mcs
Применить обновление маршрутизации
monqctl release update routing --module=mcs
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
PLUGINS (plugins)
Выполнить импорт контейнеров в репозиторий обновляемого экземпляра Monq
monqctl release update images --module=plugins
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=plugins
Выполнить загрузку плагинов агента в центральное хранилище распространения плагинов Monq
monqctl release update agent-plugins --module=plugins --plugin=tail
monqctl release update agent-plugins --module=plugins --plugin=snmp
monqctl release update agent-plugins --module=plugins --plugin=vmwareTopologySync
monqctl release update agent-plugins --module=plugins --plugin=vmwareEventsDataFlow
monqctl instance restart microservice --microservice=pl-monq-agent
Выполнить обновление контент-паков
monqctl release update content-packs --module=plugins --replace --file=content-packs/atlassian.zip
monqctl release update content-packs --module=plugins --replace --file=content-packs/telegram.zip
monqctl release update content-packs --module=plugins --replace --file=content-packs/zabbix.zip