Перейти к основному содержимому

Инструкция по обновлению Monq до версии 8.5.0

Требования

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

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

ПродуктНовая версия
pl8.5.0
sm8.5.0
cl8.5.0
fm8.4.0
plugins8.5.0
mcs8.5.0

Уровень простоя​

Без простоя

Проведение миграции 8.4.1 -> 8.5.0​

Требования​

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

!!! MonqCtl !!!

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

Примечание

Токен доступа в Monq ReleaseHub для скачивания обновления можно взять из письма о регистрации лицензии или получить, обратившись в техническую поддержку Monq.

Выполнить предрелизную подготовку​

  1. Проверить контекст monqctl и статус реестра микросервисов

    # Просмотреть текущий контекст, с которым работает monqctl
    monqctl config current-context

    # Просмотреть статус реестра микросервисов из контекста
    monqctl registry get status

    # Просмотреть статус сервисов в реестре микросервисов из контекста
    monqctl registry get services

  2. Установить контекст релиза, с которым будет работать 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" не успел перезапуститься после обновления контейнера.

Запустить миграцию данных​

Перед запуском миграции рекомендуется выполнить SQL запрос в PostgreSQL для получения списка сценариев, которые могут быть затронуты при миграции данных:

select
    bs."Id",
    case bs."Type"
        when  'GlobalVisualFunction' then 'Глобальная визуальная функция'
        when 'BusinessProcessNodeHandler' then 'Действие'
        else 'Сценарий' end as "ScenarioType",
    l."Id" as "LibraryId",
    l."Name" as "LibraryName"
from "Structs" s
join "StructProperties" sp on sp."StructId" = s."Id"
join "ScenarioBlockPins" sbp on sbp."FromStructPropertyId" = sp."Id"
join "ScenarioBlocks" sb on sb."Id" = sbp."ScenarioBlockId"
join "ScenarioVersions" sv on sv."Id" = sb."ScenarioVersionId"
join "BasicScenarios" bs on bs."Id" = sv."ScenarioId"
left join "Libraries" l on l."Id" = bs."LibraryId"
where
    (s."Name" = 'SignalEventAutomatonScenario' AND sp."Name" = 'SignalAutomatonScenario')
    OR (s."Name" in ('SignalEvent', 'SignalEventBase') AND sp."Name" in ('Status', 'Severity'));
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
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​

monqctl instance scale microservice --microservice=pl-automaton-v2-processor-service-runner --replicas=1 # Задать нужное количество реплик исполнителя сценариев автоматона.

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