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

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

Требования

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

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

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

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

Приостанавливается обработка событий на период остановки обработчиков автоматона. Без потери данных.

Проведение миграции 8.1.0 -> 8.1.1​

Требования​

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

!!! MonqCtl !!!

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

Примечание

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

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

MONQ Service Monitor (sm)​

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

monqctl release update images --module=sm

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

monqctl release update microservices --module=sm
ВНИМАНИЕ

Перед вызовом мигратора требуется остановить обработчики автоматона.

Для этого требуется выполнить команду установки количества реплик обработчиков в 0.

Перед выполнением команды требуется настроенный контекст kubectl.

ВНИМАНИЕ: требуется посмотреть к-во текущих реплик pl-automaton-v2-processor-service-runner, для того, чтобы после миграции вернуть ко-во реплик в исходное состояние.

kubectl scale deploy -n production --replicas=0 pl-automaton-v2-processor-service-runner

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

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

Вернуть количество реплик в исходное состояние​

kubectl scale deploy -n production --replicas=<n> pl-automaton-v2-processor-service-runner

где <n> - исходное количетсво реплик.