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

Требования

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

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

Продукт	Новая версия
pl	8.1.0
sm	8.1.1
cl	8.1.0
fm	8.0.0
plugins	8.1.0
mcs	8.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.

1. Перед остановкой обработчиков, проверьте текущее количество реплик, чтобы после миграции вернуть их в исходное состояние

kubectl get pods -n production -l app=pl-automaton-v2-processor-service-runner --no-headers | wc -l

2. Выполните остановку

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> - исходное количетсво реплик.