Перейти к основному содержимому

Релиз v6.7.0

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

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

ПродуктНовая версия
pl6.7.0
sm6.7.0
cl6.7.0
fm6.7.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 в реестре микросервисов не реализованы методы генерирования шаблонов микросервисов, поэтому и выбрасывается ошибка валидации. Будет исправлено в последующих версиях.

  1. Установить контекст релиза, с которым будет работать monqctl в рамках контекста установленного Monq. Команда при этом скачивает и подготавливает релиз.
monqctl release use-version 6.7.0 --product=monq

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

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

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

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

monqctl release update microservices --module=pl

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

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

Monq Service Monitor (sm)​

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

monqctl release update images --module=sm

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

monqctl release update microservices --module=sm

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

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

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

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

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

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

Удалить старые очереди 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.

keys="connector.delete identity.user.delete identity.user.update monitoring.trigger.delete priority-transfer.delete priority-transfer.update"
for key in ${keys}; do
  curl -X DELETE -u ${RMQ_USER}:${RMQ_PASS} ${RMQ_HOST}/api/bindings/%2F/e/${prefix}_smon_direct/q/${prefix}_sm_zabbix_connector_api_service/${key}
done

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

monqctl release update migrator --module=sm --command="migrate zabbix-attributes"

Monq Collector (cl)​

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

monqctl release update images --module=cl

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

monqctl release update microservices --module=cl

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.2.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