Релиз v6.10.1

Требования

Предыдущая версия monq	6.10.0

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

Продукт	Новая версия
pl	6.10.1
sm	6.10.1
cl	6.10.1
fm	6.9.1
plugins	6.10.1

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

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

Базовая информация

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

Проведение миграции

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

Требования

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

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

Примечание 2: токен для доступа в monq ReleaseHub для скачивания обновления требуется получить, обратившись в поддержку monq, либо из письма с регистрацией лицензии.

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

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

   # Просмотреть текущий контекст, с которым работает monqctl.
   monqctl config current-context
   # Просмотреть статус реестра микросервисов из контекста.
   monqctl registry get status
   # Просмотреть статус сервисов в реестре микросервисов из контекста.
   monqctl registry get services

   Примечание: В ответе на команду monqctl registry get status вывод будет содержать

   -------------------------
   Consul         | Failed 
   -------------------------         

   На данном этапе можно проигнорировать. Сервис Consul добавлен только для возможности получить адрес и токен monqctl, который формирует файл доступа для программы-мигратора. Но для Consul в реестре микросервисов не реализованы методы генерирования шаблонов микросервисов, поэтому и выбрасывается ошибка валидации. Будет исправлено в последующих версиях.

2. Установить контекст релиза, с которым будет работать monqctl в рамках контекста установленного Monq. Команда при этом скачивает и подготавливает релиз.

   monqctl release use-version 6.10.1 --product=monq

При обновлении из папки

# Требуется выполнить экспорт релиза в папку
monqctl release version export 6.10.1 --product=monq --dest=<export directory>

# Выполнить команду `use-version` с аргументом `--sourceDir`.
monqctl release use-version 6.10.1 --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-automaton-rules-api-service --file sqls/pl-automaton-rules-api-service.sql

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

monqctl release update microservices --module=pl

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

# Получить токен администратора пространства с правами WRITE через интерфейс (pl/profile?tab=private-tokens) либо выписать с помощью программы monq-identity.
TOKEN="*******"
# Задать домен monq
Monq_DOMAIN="monq.local"
# Выполнить операции
CONTEXT=$(monqctl config current-context)
IMPORT=$(cat /tmp/monqctl/updates/${CONTEXT}/monq/6.10.1/pl/automaton-libs/automaton.cl.import)
curl -v -k -X POST -H "Authorization: Bearer ${TOKEN}" -H 'Content-Type: application/json' \
https://${Monq_DOMAIN}/api/webui/pl/v2/automaton/libraries/update \
-d "{\"EncodedLibrary\":\"${IMPORT}\"}"

Убедится, что запрос вернул HTTP 200. При ошибке HTTP 500 и сообщении в теле ответа "Operation timeout exception" повторить запрос.

Сбросить кэш для микросервисов

monqctl instance clear cache --microservice=pl-i18n-service

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

# Проверить, что kubectl контекст смотрит на нужный контур.
kubectl config current-context

# Перезапустить поды.
namespace="" # указать K8s Namespace. По умолчанию, production. Для stage контуров - staging.
kubectl delete po -n ${namespace} -l app=pl-automaton-v2-processor-service-runner

Monq Service Monitor (sm)

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

monqctl release update images --module=sm

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

monqctl release update db pgsql --module=sm --microservice=sm-sla-service --file sqls/sm-sla-service.sql

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

monqctl release update microservices --module=sm

---

Monq Collector (cl)

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

monqctl release update images --module=cl

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

monqctl release update microservices --module=cl

---

PLUGINS (plugins)

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

monqctl release update images --module=plugins

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

monqctl release update microservices --module=plugins