Инструкция по обновлению Monq до версии 8.5.0
Требования
Предыдущая версия Monq: 8.4.1
В обновлении:
| Продукт | Новая версия |
|---|---|
| pl | 8.5.0 |
| sm | 8.5.0 |
| cl | 8.5.0 |
| fm | 8.4.0 |
| plugins | 8.5.0 |
| mcs | 8.5.0 |
Уровень простоя
Без простоя
Проведение миграции 8.4.1 -> 8.5.0
Требования
Для запуска обновления требуется скачать клиент управления Monq monqctl и выполнить конфигурацию контекста monqctl, если ранее этого не выполнялось.
!!! MonqCtl !!!
Минимальная версия monqctl: 1.16.1
Примечание
Токен доступа в Monq ReleaseHub для скачивания обновления можно взять из письма о регистрации лицензии или получить, обратившись в техническую поддержку Monq.
Выполнить предрелизную подготовку
-
Проверить контекст monqctl и статус реестра микросервисов
# Просмотреть текущий контекст, с которым работает monqctl
monqctl config current-context
# Просмотреть статус реестра микросервисов из контекста
monqctl registry get status
# Просмотреть статус сервисов в реестре микросервисов из контекста
monqctl registry get services -
Установить контекст релиза, с которым будет работать
monqctlв рамках контекста установленного MonqКоманда при этом скачивает и подготавливает релиз для установки.
monqctl release use-version 8.5.0 --product=monq
При обновлении из папки
# Требуется выполнить экспорт релиза в папку
monqctl release version export 8.5.0 --product=monq --dest=<export directory>
# Выполнить команду `use-version` с аргументом `--sourceDir`.
monqctl release use-version 8.5.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-user-shared-filters-api-service --file sqls/pl-user-shared-filters-api-service.sql
monqctl release update db pgsql --module=pl --microservice=pl-agents-service --file sqls/pl-agents-service.sql
Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes
monqctl release update microservices --module=pl
Обновить существующие и установить новые библиотеки автоматона
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.signals.import
При ошибке HTTP 500 и сообщении в теле ответа "Operation timeout exception" повторить команды. Такая ошибка может возникнуть, если микросервис "pl-automaton-v2-service" не успел перезапуститься после обновления контейнера.
Запустить миграцию данных
monqctl release update migrator --module=pl --command="migrate bp"
monqctl release update migrator --module=pl --command="migrate automaton"
Перезапустить микросервисы автоматон 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-runner
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
MONQ Service Monitor (sm)
Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра MONQ
monqctl release update images --module=sm
Остановить сервис исполнитель сценариев автоматона и сервис сигналов
monqctl instance scale microservice --microservice=sm-signals-service --replicas=0
# проверить и запомнить исходное количество реплик исполнителя сценариев автоматона
kubectl get pod -A | grep -E 'pl-.*-service-runner' | wc -l
# затем остановить сервис
monqctl instance scale microservice --microservice=pl-automaton-v2-processor-service-runner --replicas=0
Выполнить конфигурацию баз данных микросервисов
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 migrator --module=sm --command="migrate signals"
Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes
monqctl release update microservices --module=sm
Применить новую маршрутизацию
monqctl release update routing --module=sm
Выполнить запуск pl-automaton-v2-processor-service-runner
# в --replicas=1 указать исходное количество реплик исполнителя сценариев автоматона
monqctl instance scale microservice --microservice=pl-automaton-v2-processor-service-runner --replicas=1
Выполнить перезапуск pl-automaton-v2-processor-service
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service
MONQ Collector (cl)
Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра MONQ
monqctl release update images --module=cl
Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes
monqctl release update microservices --module=cl
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
Agent plugins + content packs
Выполнить закачку плагинов агента в центральное хранилище распространения плагинов Monq
monqctl release update agent-plugins --module=plugins --plugin=tail
monqctl release update agent-plugins --module=plugins --plugin=zabbixCheckConnection
monqctl release update agent-plugins --module=plugins --plugin=zabbixCheckVersion
monqctl release update agent-plugins --module=plugins --plugin=zabbixEventsDataFlow
monqctl instance restart microservice --microservice=pl-monq-agent
Выполнить загрузку контент-паков
monqctl release update content-packs --module=plugins --replace --file=content-packs/prometheus.zip
monqctl release update content-packs --module=plugins --replace --file=content-packs/k8s.zip