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

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

Требования

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

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

ПродуктНовая версия
pl7.2.1
sm7.2.1
cl7.2.0
fm7.2.0
plugins7.2.0

Уровень простоя - без простоя.

Релиз Monq 7.2.1 - Базовая информация​

Релиз включает обновление различных модулей Monq. Если установлен только определенный набор модулей, например: pl и cl, то разделы с остальными модулями можно проигнорировать.

Проведение миграции 7.2.0 -> 7.2.1​

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

!!! MonqCtl !!!

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

Примечание: можно настроить 2 контекста для stage и production одновременно.

Примечание 2: токен для доступа в 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 7.2.1 --product=monq
При обновлении из папки
# Требуется выполнить экспорт релиза в папку
monqctl release version export 7.2.1 --product=monq --dest=<export directory>

# Выполнить команду `use-version` с аргументом `--sourceDir`.
monqctl release use-version 7.2.1 --product=monq --sourceDir=<папка с экспортированным обновлением>

Monq Platform (pl)​

Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра Monq​

monqctl release update images --module=pl

Выполнить конфигурацию баз данных микросервисов​

monqctl release update db pgsql --module=pl --microservice=pl-tags-api-service --file sqls/pl-tags-api-service.sql

Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes​

monqctl release update microservices --module=pl

Обновить существующие и установить новые библиотеки автоматона​

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

При ошибке HTTP 500 и сообщении в теле ответа "Operation timeout exception" повторить команды.

Перезапустить микросервисы автоматон v2​

monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service-runner

Monq Service Monitor (sm)​

Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра Monq​

monqctl release update images --module=sm

Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes​

monqctl release update microservices --module=sm

Провести миграцию для сервиса РСМ​

# Выполнить миграцию. Для выполнения миграции потребуется создать временный ingress для доступа к точке запуска миграций сервиса sm-rsm-service. После применения миграции, временный ingress будет удален.

monqctl release update routing --module=sm --file sm-routing-migration.json
monqctl release exec shell --module=sm --file=rsm_migration.sh

# Удалить маршрутизацию для миграции.
monqctl registry delete microservice sm-routing-migration

Запустить мигратор​

monqctl release update migrator --module=sm --command="migrate config-items-extended-info"