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

Релиз v6.12.0

Требования
  • Предыдущая версия monq == 6.11.0

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

ПродуктНовая версия
pl6.12.0
sm6.12.0
cl6.12.0
fm6.11.1
plugins6.11.0
⚠️ Уровень простоя - без простоя.

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

Релиз включает обновление основных компонентов СПО и различных модулей monq.

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

При прочтении данной инструкции необходимо особое внимание уделять цветным блокам и уточнять все условия, которые в них указаны.

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

Требования

Обновить клиент monqctl до версии 1.3.1.

  • Добавилась команда на установку или обновление библиотек автоматона.

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

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

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

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

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

monqctl registry update registry --version=3.5.2

Выполнить обновление шаблонов k8s в реестре микросервисов​

# Получить текущий шаблон k8s из реестра микросервисов.
monqctl registry get services K8s --output json > registry-k8s-template.backup.json
# Выполнить обновление шаблона.
globalDomain=$(cat registry-k8s-template.backup.json | jq -r '.JsonConfig.Parameters[] | select(.Name=="%GlobalDomain%") | .Value')
cat registry-k8s-template.backup.json | jq --arg domain "$globalDomain" \
'.JsonConfig.Parameters |= . + [{Name:"%ExternalDomain%",Value:$domain}]' > registry-k8s-template.json
# Применить обновленный шаблон в реестр.
monqctl registry apply service K8s --file registry-k8s-template.json

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

  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.12.0 --product=monq
При обновлении из папки
# Требуется выполнить экспорт релиза в папку
monqctl release version export 6.12.0 --product=monq --dest=<export directory>

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

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

monqctl release update microservices --module=pl

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

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

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

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

Обновить существующие и установить новые библиотеки автоматона​

monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.core.import
monqctl release update automaton-libraries --module=pl --file=automaton-libs/automaton.cmdb.import

При ошибке HTTP 500 и сообщении в теле ответа "Operation timeout exception" повторить команды.

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

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

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

Выполнить обновление маршрутизации​

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=sm-rsm-mode-api-service --file sqls/sm-rsm-mode-api-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 release update migrator --module=cl --command="migrate removed-streams-agent-tasks"
monqctl release update migrator --module=cl --command="migrate zabbix-stream-params"

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

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

Выполнить обновление маршрутизации​

monqctl release update routing --module=cl

Test Forge (fm)​

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

monqctl release update images --module=fm

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

monqctl release update microservices --module=fm

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

monqctl release update routing --module=fm

PLUGINS (plugins)​

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

monqctl release update images --module=plugins

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

monqctl release update microservices --module=plugins

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

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

# Обновить плагины
namespace="" # указать K8s Namespace. По умолчанию, production. Для STAGE контуров - staging.
monq_agent=$(kubectl get po -n ${namespace} -l app=pl-monq-agent -o=jsonpath='{.items[0].metadata.name}')
plugins="zabbixEventsDataFlow/v1.3.0 zabbixCheckVersion/v1.1.0 zabbixCheckConnection/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

Проверка​

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

Installing 0 certificates from /certs ...
Loading plugins from /storage/plugins...
...
[Zabbix - Events Data Flow v1.3.0] was loaded.
[Zabbix - Check Version v1.1.0] was loaded.
[Zabbix - Check Connection v1.1.0] was loaded.
...
N plugins was loaded.

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

monqctl release update routing --module=plugins