Релиз v6.8.0

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

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

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

Уровень простоя - возможна деградация интерфейса, связанная с РСМ.

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

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

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

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

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

Примечание: можно настроить 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.8.0 --product=monq

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

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

# Выполнить команду `use-version` с аргументом `--sourceDir`.
monqctl release use-version 6.8.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-userspaces-api-service --file userspace-configuration.sql
monqctl release update db pgsql --module=pl --microservice=pl-identity-service --file sqls/pl-identity-service.sql
monqctl release update db pgsql --module=pl --microservice=pl-connectors-dispatcher-api-service --file sqls/pl-connectors-dispatcher-api-service.sql

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

monqctl release update microservices --module=pl
# Выполнить полное обновление шаблона агента из-за изменений в лимитах k8s.
monqctl release update microservices --module=pl --microservice=pl-monq-agent --k8s-merge-type=Replace

Выполнить создание схемы БД для новых микросервисов

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

Сбросить кэш identity и перезапустить миксервис pl-automaton-v2-service для корректного применения авторизационных данных.

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

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

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

Импортировать библиотеки автоматона

# Получить токен администратора пространства с правами 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.8.0/pl/automaton-libs/monq.core.import)
curl -v -k -X POST -H "Authorization: Bearer ${TOKEN}" -H 'Content-Type: application/json' \
https://${Monq_DOMAIN}/api/webui/pl/v2/automaton/libraries/import \
-d "{\"import\":\"${IMPORT}\"}"

IMPORT=$(cat /tmp/monqctl/updates/${CONTEXT}/monq/6.8.0/pl/automaton-libs/monq.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/import \
-d "{\"import\":\"${IMPORT}\"}"

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

Запустить миграции с помощью мигратора

monqctl release update migrator --module=pl --command="migrate automaton"
monqctl release update migrator --module=pl --command="migrate workgroups"

Применить новую маршрутизацию

monqctl release update routing --module=pl

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

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

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

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

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

Проверка:

1. Проверить логи микросервиса pl-automaton-v2-processor-service. Лог должен содержать записи о регистрации раннера и отправку заданий на обработку сообщений для маршрутного узла CMDBAutodiscovery.

[2022-03-05 22:10:37 +03:00 INF]  Cache initialized with 1 routing nodes.
[2022-03-05 22:10:37 +03:00 INF]  Runner with ID: AIo1SbDrVuqfgbaHUM2BRA registered.
[2022-03-05 22:10:37 +03:00 INF]  Runner with Id AIo1SbDrVuqfgbaHUM2BRA connected.
[2022-03-05 22:10:37 +03:00 INF]  Sent request to runner with Id=AIo1SbDrVuqfgbaHUM2BRA for RoutingNode CMDBAutodiscovery with Id=1

2. Проверить логи микросервиса pl-automaton-v2-processor-service-runner Лог должен содержать запись о получении задания на обработку сообщений для маршрутного узла CMDBAutodiscovery

[2022-03-05 22:11:35 +03:00 INF]  Connecting to the automaton coordinator.
[2022-03-05 22:11:36 +03:00 INF]  Connection established.
[2022-03-05 22:11:36 +03:00 INF]  Received routing node {
  "Id": 1,
  "Name": "CMDBAutodiscovery",
  "RunnersCount": 1,
  "ExclusiveRunner": false,
  "InboundEvents": [
    {
      "OutboundEventId": 1,
      "RoutingKey": "cl-log-event"
    }
  ]
}

В RabbitMQ должна появиться очередь (live)_pl_automaton_1. live может отличаться в зависимости от контура, например, stage. "1" может иметь другое значение. Если runner не может подключиться требуется повысить уровень лога для этого микросервиса. Для этого в Consul в ключе (production)/pl/pl-automaton-v2-processor-service/appsettings-runner.json требуется добавить секцию

"Serilog": {
    "MinimumLevel": {
      "Default": "Debug",
      "Override": {
        "Microsoft": "Debug",
        "System": "Debug"
      }
    }
}

и перезапустить микросервис (см. выше).

---

Monq Service Monitor (sm)

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

monqctl release update images --module=sm

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

# если возникнет ошибка можно пропустить данную команду
monqctl release update db pgsql --module=sm --microservice=sm-hpsm-service-desk-api-service --file sqls/sm-hpsm-service-desk-api-service.sql

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

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

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

monqctl release update microservices --module=sm

Применить новую маршрутизацию

monqctl release update routing --module=sm

---

Monq Collector (cl)

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

monqctl release update images --module=cl

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

monqctl release update db pgsql --module=cl --microservice=cl-streams-service --file sqls/cl-streams-service.sql

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

monqctl release update microservices --module=cl

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

monqctl instance clear cache --microservice=cl-streams-service

---

Test Forge (fm)

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

monqctl release update images --module=fm

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

monqctl release update db pgsql --module=fm --microservice=pl-userspaces-api-service --file userspace-configuration.sql
monqctl release update db pgsql --module=fm --microservice=fm-projects-api-service --file sqls/fm-projects-api-service.sql

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

monqctl release update microservices --module=fm

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

monqctl instance clear cache --microservice=pl-userspaces-api-service