Инструкция по обновлению Monq до версии 8.7.0
В этом обновлении
| Продукт | Новая версия |
|---|---|
| pl | 8.7.0 |
| sm | 8.7.0 |
| cl | 8.7.0 |
| fm | 8.7.0 |
| mcs | 8.7.0 |
| plugins | 8.7.0 |
Уровень простоя
Без простоя
Проведение миграции 8.6.0 → 8.7.0
Требования
Минимальная версия Monq: 8.6.0
Минимальная версия monqctl: 1.16.1
Для запуска обновления требуется скачать клиент управления Monq monqctl и выполнить конфигурацию контекста monqctl, если ранее этого не выполнялось.
Токен доступа
в Monq ReleaseHub для скачивания обновления можно взять из письма о регистрации лицензии или получить, обратившись в техническую поддержку Monq
Выполнить предрелизную подготовку
Проверить контекст monqctl и статус реестра микросервисов
# Просмотреть текущий контекст, с которым работает monqctl
monqctl config current-context
# Просмотреть статус реестра микросервисов из контекста
monqctl registry get status
# Просмотреть статус сервисов в реестре микросервисов из контекста
monqctl registry get services
Установить контекст релиза, с которым будет работать monqctl в рамках контекста установленного Monq
Команда при этом скачивает и подготавливает релиз для установки.
monqctl release use-version 8.7.0 --product=monq
Закрытый контур / обновление из папки
На системе с доступом к сети интернет, установленном и настроенном monqctl, выполнить экспорт релиза в папку
monqctl release version export 8.7.0 --product=monq --dest=<export directory>
После переноса папки на сервер выполнить команду с аргументом --sourceDir
monqctl release use-version 8.7.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-userspaces-api-service --file userspace-configuration.sql
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=pl
Обновить существующие и установить новые библиотеки "автоматон 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.signals.import
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.notification.import
При ошибке HTTP 500 и сообщении в теле ответа "Operation timeout exception" - повторить команды.
Такая ошибка может возникнуть если микросервис "pl-automaton-v2-service" не успел перезапуститься после обновления контейнера.
Перезапустить микросервисы "автоматон 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 release update routing --module=pl
Сбросить кэш для микросервисов
monqctl instance clear cache --microservice=pl-i18n-service
Перезапустить микросервис исполнитель сценариев "автоматон v2"
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service-runner
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
MONQ Service Monitor (sm)
Выполнить импорт контейнеров в Docker репозиторий обновляемого экземпляра Monq
monqctl release update images --module=sm
Выполнить обновление набора прав
monqctl release update user-grants --module=sm --file=user-grants.json
monqctl release update user-grants --module=pl --file=user-grants.json
Сбросить кэш для микросервисов
monqctl instance clear cache --microservice=pl-user-grants-api-service
monqctl instance clear cache --microservice=pl-userspace-admins-service
Выполнить конфигурацию баз данных микросервисов
monqctl release update db pgsql --module=sm --microservice=sm-signals-service --file sqls/sm-signals-service.sql
monqctl release update db clickhouse --module=sm --microservice=sm-signals-service --file sqls/sm-signals-service-clickhouse.sql
monqctl release update db pgsql --module=sm --microservice=pl-userspace-admins-service --file sqls/pl-userspace-admins-service.sql
monqctl release update db pgsql --module=sm --microservice=pl-userspaces-api-service --file userspace-configuration.sql
Запустить миграцию данных
monqctl release update migrator --module=sm --command="migrate signals"
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=sm
Применить обновление маршрутизации
monqctl release update routing --module=sm
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
MONQ Collector (cl)
Выполнить импорт контейнеров в Docker репозиторий обновляемого экземпляра Monq
monqctl release update images --module=cl
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=cl
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
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 microservices --module=fm
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
MONQ Metrics (mcs)
Выполнить импорт контейнеров в Docker репозиторий обновляемого экземпляра Monq
monqctl release update images --module=mcs
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=mcs
Продолжать только при пустом выводе команды:
kubectl get pod -A | grep -v Running
PLUGINS (plugins)
Выполнить импорт контейнеров в Docker репозиторий обновляемого экземпляра Monq
monqctl release update images --module=plugins
Выполнить обновление и конфигурацию микросервисов
monqctl release update microservices --module=plugins
Выполнить загрузку контент-паков
monqctl release update content-packs --module=plugins --replace --file=content-packs/internal-user-notifications.zip