Релиз v6.2.0

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

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

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

Уровень простоя - незначительная деградация интерфейса.

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

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

Выполнить бэкапы баз данных:

• pl_user_grants_api_service
• cl_streams_service
• pl_userspaces_api_service

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

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

Примечание

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

Примечание

Токен для доступа в 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.2.0 --product=monq

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

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

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

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

monqctl release update microservices --module=pl

Выполнить конфигурацию баз данных для pl-agents-service

monqctl release update db pgsql --module=pl --microservice=pl-agents-service --file sqls/pl-agents-service.sql
monqctl release update db clickhouse --module=pl --microservice=pl-agents-service --file sqls/pl-agents-service-clickhouse.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
monqctl instance clear cache --microservice=pl-identity-service

Выполнить рестарт сервиса pl-agents-service

Данную процедуру требуется выполнить из-за того, что сервис в k8s запускается раньше, чем генерируется информация по аутентификации для сервиса. Поэтому читается неправильный конфиг файл из Consul, в котором не до конца определена секция аутентификации. После рестарта сервис нормально запустится.

namespace="production"
kubectl delete po -n ${namespace} -l app=pl-agents-service

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

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

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

monqctl release update microservices --module=sm

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

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=cl-streams-service --file sqls/cl-streams-service.sql
monqctl release update db pgsql --module=cl --microservice=pl-userspaces-api-service --file userspace-configuration.sql

Выполнить миграцию данных с помощью мигратора

monqctl release update migrator --module=pl --command="migrate agent-grants"
monqctl release update migrator --module=pl --command="migrate agent-tasks"
monqctl release update migrator --module=cl --command="migrate configuration-templates"

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

monqctl release update microservices --module=cl

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

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

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

namespace="production"
monq_agent=$(kubectl get po -n ${namespace} -l app=pl-monq-agent -o=jsonpath='{.items[0].metadata.name}')
plugins="nagiosCheckConnection nagiosEventsDataFlow scomCheckConnection scomEventsDataFlow vmwareEventsDataFlow vmwareTopologySync zabbixCheckConnection zabbixCheckVersion zabbixEventsDataFlow"

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

for plugin in ${plugins}; do
  wget https://downloads.monqlab.com/agent-plugins/${plugin}/v1.0.0/${plugin}.zip
  unzip ${plugin}.zip
  rm -f ${plugin}.zip
  kubectl cp ${plugin} ${namespace}/${monq_agent}:/storage/plugins
  rm -rf ${plugin}
done

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

---

Test Forge (fm)

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

monqctl release update images --module=fm

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

monqctl release update microservices --module=fm