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

Релиз v6.8.1

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

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

ПродуктНовая версия
pl6.8.1
sm6.8.1
cl6.8.0
fm6.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.1 --product=monq
При обновлении из папки
# Требуется выполнить экспорт релиза в папку
monqctl release version export 6.8.1 --product=monq --dest=<export directory>

# Выполнить команду `use-version` с аргументом `--sourceDir`.
monqctl release use-version 6.8.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

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

monqctl release update microservices --module=pl

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

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

Monq Service Monitor (sm)

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

monqctl release update images --module=sm

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

monqctl release update microservices --module=sm

Monq Collector (cl)

Без изменений


Test Forge (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="vmwareTopologySync/v1.1.2"

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

Проверка обновления плагинов системного агента

В логе микросервиса pl-monq-agent должны отобразится загруженные плагины правильных версий

Installing 0 certificates from /certs ...
Loading plugins from /storage/plugins...
...
[VMware - Topology Sync v1.1.2.0] was loaded.
...
11 plugins was loaded.