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

Инструкция по обновлению Monq до версии 7.10.0

Требования

Предыдущая версия Monq: 7.9.1

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

ПродуктНовая версия
pl7.10.0
sm7.10.0
cl7.10.0
fm7.10.0
plugins7.9.0
mcs7.10.0

Уровень простоя - без простоя.

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

Проведение миграции 7.9.1 -> 7.10.0​

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

!!! MonqCtl !!!

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

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

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

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

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

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

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

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

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

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

monqctl registry update registry --version=3.13.0
# Просмотреть статус реестра микросервисов после обновления.
monqctl registry get status
При обновлении из папки
mkdir registry
monqctl registry export registry 3.13.0  --dest=./registry/
cd registry
monqctl registry update registry --version=3.13.0 --sourceDir=./

# Просмотреть статус реестра микросервисов после обновления
monqctl registry get status

rm -rf ../registry

Выполнить обновление шаблонов​

probe='{"httpGet":{"path":"/ready","port":5005,"scheme":"HTTP"},"failureThreshold":30,"periodSeconds":10,"timeoutSeconds":5}'
containerGrpc='{"name":"%AppName%","image":"%PrivateRegistryAddress%/%ContainerName%:%AppVersion%","ports":[{"name":"http-local","containerPort":5005,"protocol":"TCP"},{"name":"grpc-local","containerPort":5006,"protocol":"TCP"}],"env":[{"name":"ASPNETCORE_ENVIRONMENT","value":"%AspnetcoreEnviroment%"},{"name":"ASPNETCORE_APPLICATION_NAME","value":"%Name%"}],"volumeMounts":[{"name":"consul-config-volume","mountPath":"/app/aspnet_consul_config.json","subPath":"aspnet_consul_config.json"},{"name":"monq-ca-certificates","mountPath":"/certs"}],"livenessProbe":{"httpGet":{"path":"/api/version","port":5005,"scheme":"HTTP"},"initialDelaySeconds":10,"periodSeconds":30},"startupProbe":{"httpGet":{"path":"/ready","port":5005,"scheme":"HTTP"},"failureThreshold":30,"periodSeconds":10,"timeoutSeconds":5}}'

monqctl registry get services K8s --output=json > ./registry-k8s-template-backup.json

cat ./registry-k8s-template-backup.json | jq --argjson probe ${probe} --argjson containerGrpc ${containerGrpc} \
'.JsonConfig."Container-api".startupProbe = $probe | del(.JsonConfig."container-grpc") | .JsonConfig."Container-grpc" = $containerGrpc' > registry-k8s-template.json

monqctl registry apply service K8s --file registry-k8s-template.json

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

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

monqctl release update microservices --module=pl --k8s-merge-type=Replace --full

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

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

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

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

Если возникла ошибка Error connecting to https://<FQDN>/.well-known/openid-configuration. The SSL connection could not be established - добавить к команде --skip-ssl-verify.

Если возникла ошибка HTTP 500 Operation timeout exception - повторить команды. Такая ошибка может возникнуть, если микросервис не успел перезапуститься при обновлении.

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

monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service-runner
monqctl instance restart microservice --microservice=pl-automaton-v2-processor-service-compiler

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 --k8s-merge-type=Replace --full

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

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

monqctl release update microservices --module=cl --k8s-merge-type=Replace --full

Test Forge (fm)​

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

monqctl release update db pgsql --module=fm --microservice=pl-userspaces-api-service --file userspace-configuration.sql

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

monqctl release update microservices --module=fm --k8s-merge-type=Replace --full

Monq Metrics (mcs)​

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

monqctl release update images --module=mcs

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

monqctl release update db pgsql --module=mcs --microservice=pl-userspaces-api-service --file userspace-configuration.sql

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

monqctl release update microservices --module=mcs --k8s-merge-type=Replace --full

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

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

PLUGINS (plugins)​

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

monqctl release update microservices --module=plugins --k8s-merge-type=Replace --full