Релиз v6.6.0


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

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

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

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

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

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

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

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

!Рекомендуемая версия monqctl: 1.2.1

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

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

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

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

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

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

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

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

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

monqctl release use-version 6.6.0 --product=monq

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

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

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

При возникновении ошибки:

The SSL connection could not be established, see inner exception.

необходимо обновить корневые сертификаты безопасности ОС.
yum install ca-certificates

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-user-grants-api-service --file sqls/pl-user-grants-api-service.sql

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

monqctl release update microservices --module=pl

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

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

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

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

Перезапустить миксервис pl-user-groups-service для корректного применения авторизационных данных.

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

# Обновить плагины
namespace="" # указать K8s Namespace. По умолчанию, production.
kubectl delete po -n ${namespace} -l app=pl-user-groups-service
kubectl delete po -n ${namespace} -l app=pl-user-groups-service-synchronizer

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

monqctl release update routing --module=pl

Monq Service Monitor (sm)

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

monqctl release update images --module=sm

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

monqctl release update db pgsql --module=sm --microservice=pl-userspaces-api-service --file userspace-configuration.sql
monqctl release update db pgsql --module=sm --microservice=sm-integral-events-configurator-api-service --file sqls/sm-integral-events-configurator-api-service.sql
monqctl release update db pgsql --module=sm --microservice=sm-sla-service --file sqls/sm-sla-service.sql
monqctl release update db arangodb --module=sm --microservice=sm-rsm-service --file sqls/sm-rsm-service.aql

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

monqctl release update microservices --module=sm

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

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

kubectl config current-context

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

# Переменная заполняется вручную.
globalDomain="" # указать домен, по которому пользователи попадают в интерфейс. Например, https://monq-domain.com

# Применить маршрутизацию для миграции.
monqctl release update routing --module=sm --file sm-routing-migration.json

# Выполнить миграцию БД.
curl -iL -k -X POST -d "" ${globalDomain}/api/sm/v2/rsm/migrations/v12

# Убедится, что HTTP запрос вернул "HTTP/2 204"

# Удалить маршрутизацию для миграции.
namespace="" # указать K8s Namespace. По умолчанию, production.

registryUrl=$(kubectl get ing -n ${namespace} pl-microservice-registry-api-service -o=jsonpath='{.spec.rules[0].host}')
registryToken=$(kubectl get secret -n ${namespace} registry-token -o=jsonpath='{.data.secure_token}' | base64 -d)
curl -X DELETE -H "Authorization: Bearer ${registryToken}" ${registryUrl}/api/pl/microservices?microserviceName=sm-routing-migration

Удалить старые очереди RabbitMQ и отбиндить ключи маршрутизации

RMQ_CRED=$(monqctl registry get services RabbitMQ --output json)
RMQ_HOST=$(echo ${RMQ_CRED} | jq -r .Host)
RMQ_USER=$(echo ${RMQ_CRED} | jq -r .RootLogin)
RMQ_PASS=$(echo ${RMQ_CRED} | jq -r .RootPassword)


prefix="" # установить префикс названия очередей. По умолчанию live.
queues="${prefix}_sm_sla_service_ordered"
for queue in ${queues}; do
  curl -X DELETE -u ${RMQ_USER}:${RMQ_PASS} ${RMQ_HOST}/api/queues/%2F/${queue}
done

keys="cl.stream.command.update-status pl.agent-task.event.new"
for key in ${keys}; do
  curl -X DELETE -u ${RMQ_USER}:${RMQ_PASS} ${RMQ_HOST}/api/bindings/%2F/e/${prefix}_smon_direct/q/${prefix}_cl_streams_service/${key}
done

# Ошибки {"error":"Object Not Found","reason":"Not Found"} можно проигнорировать.

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

monqctl release update migrator --module=sm --command="migrate config-item-types"
monqctl release update migrator --module=sm --command="migrate of-type-edges"
monqctl release update migrator --module=sm --command="migrate config-item-types-in-not-existing-userspaces"
monqctl release update migrator --module=sm --command="migrate default-life-cycle"

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

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

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

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=pl-userspaces-api-service --file userspace-configuration.sql
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=pl-userspaces-api-service

Test Forge (fm)

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

monqctl release update images --module=fm

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

monqctl release update microservices --module=fm

Выполнить обновление плагинов системного агента

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

# Обновить плагины
namespace="" # указать K8s Namespace. По умолчанию, production.
monq_agent=$(kubectl get po -n ${namespace} -l app=pl-monq-agent -o=jsonpath='{.items[0].metadata.name}')
plugins="zabbixEventsDataFlow/v1.1.0 vmwareTopologySync/v1.1.1 vmwareEventsDataFlow/v1.1.0"

mkdir ./agent-plugins
cd ./agent-plugins
kubectl exec -it -n ${namespace} ${monq_agent} -- mkdir -p /storage/plugins

for plugin in ${plugins}; do
  pluginName=$(echo ${plugin} | awk -F'/' '{print $1}')
  wget https://downloads.monqlab.com/agent-plugins/${plugin}/${pluginName}.zip
  unzip ${pluginName}.zip
  rm -f ${pluginName}.zip
  kubectl cp ${pluginName} ${namespace}/${monq_agent}:/storage/plugins
  rm -rf ${pluginName}
done

kubectl delete po -n ${namespace} -l app=pl-monq-agent

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

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

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

Monq Platform (pl)​

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

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

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

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

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

Перезапустить миксервис pl-user-groups-service для корректного применения авторизационных данных.​

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

Monq Service Monitor (sm)​

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

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

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

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

Удалить старые очереди RabbitMQ и отбиндить ключи маршрутизации​

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

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

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

Monq Collector (cl)​

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

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

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

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

Test Forge (fm)​

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

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

Выполнить обновление плагинов системного агента​

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

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

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

Monq Platform (pl)

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

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

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

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

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

Перезапустить миксервис pl-user-groups-service для корректного применения авторизационных данных.

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

Monq Service Monitor (sm)

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

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

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

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

Удалить старые очереди RabbitMQ и отбиндить ключи маршрутизации

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

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

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

Monq Collector (cl)

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

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

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

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

Test Forge (fm)

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

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

Выполнить обновление плагинов системного агента