Релиз v6.3.0
| Предыдущая версия | 6.2.2 |
В обновлении:
| Продукт | Новая версия |
|---|---|
| pl | 6.3.0 |
| sm | 6.3.0 |
| cl | 6.3.0 |
| fm | 6.3.0 |
Уровень простоя - незначительная деградация интерфейса.
Базовая информация
Релиз включает обновление различных модулей Monq. Если установлен только определенный набор модулей, например: pl и cl, то разделы с остальными модулями можно проигнорировать.
!!! Выполнить бэкапы баз данных:
- PGSQL: pl_identity_service
- PGSQL: pl_work_groups_api_service
- PGSQL: pl_user_grants_api_service
- ARANGO: sm_rsm_service
Проведение миграции
Для запуска обновления требуется скачать клиент управления Monq monqctl и выполнить конфигурацию контекста monqctl.
!Рекомендуемая версия monqctl: 1.2.1
Примечание: можно настроить 2 контекста для stage и production одновременно.
Прим ечание 2: токен для доступа в Monq ReleaseHub для скачивания обновления требуется получить, обратившись в поддержку Monq, либо из письма с регистрацией лицензии.
Выполнить обновление реестра микросервисов
monqctl registry update registry --version=3.3.0
Выполнить предрелизную подготовку
- Проверить контекст monqctl и статус реестра микросервисов.
# Просмотреть текущий контекст, с которым работает monqctl.
monqctl config current-context
# Просмотреть статус реестра микросервисов из контекста.
monqctl registry get status
# Просмотреть статус сервисов в реестре микросервисов из контекста.
monqctl registry get services
Примечание:
В ответе на команду monqctl registry get status вывод будет содержать
-------------------------
Consul | Failed
-------------------------
На данном этапе можно проигнорировать. Сервис Consul добавлен только для возможности получить адрес и токен monqctl, который формирует файл доступа для программы-мигратора. Но для Consul в реестре микросервисов не реализованы методы генерирования шаблонов микросервисов, поэтому и выбрасывается ошибка валидации. Будет исправлено в последующих версиях.
- Установить контекст релиза, с которым будет работать monqctl в рамках контекста установленного Monq. Команда при этом скачивает и подготавливает релиз.
monqctl release use-version 6.3.0 --product=monq
При обновлении из папки
# Требуется выполнить экспорт релиза в папку
monqctl release version export 6.3.0 --product=monq --dest=<export directory>
# Выполнить команду `use-version` с аргументом `--sourceDir`.
monqctl release use-version 6.3.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-work-groups-api-service --file sqls/pl-work-groups-api-service.sql
monqctl release update db pgsql --module=pl --microservice=pl-identity-service --file sqls/pl-identity-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
Выполнить миграцию данных с помощью мигратора
monqctl release update migrator --module=pl --command="migrate userspaceAdmins"
Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes
monqctl release update microservices --module=pl
Сбросить кэш для микросервисов
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
Применить новую маршрутизацию
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-identity-service --file sqls/pl-identity-service.sql
monqctl release update db pgsql --module=sm --microservice=pl-userspaces-api-service --file userspace-configuration.sql
monqctl release update db arangodb --module=sm --microservice=sm-rsm-service --file sqls/sm-rsm-service.aql
monqctl release update db pgsql --module=sm --microservice=sm-sla-service --file sqls/sm-sla-service.sql
Выполнить конфигурацию микросервисов в реестре для микросервисов из о бновления и применить шаблоны в Kubernetes
monqctl release update microservices --module=sm
Сбросить кэш для микросервисов
monqctl instance clear cache --microservice=pl-userspaces-api-service
monqctl instance clear cache --microservice=pl-identity-service
Monq Collector (cl)
Выполнить перекачку контейнеров в Docker репозиторий обновляемого экземпляра Monq
monqctl release update images --module=cl
Выполнить конфигурацию микросервисов в реестре для микросервисов из обновления и применить шаблоны в Kubernetes
monqctl release update microservices --module=cl
Выполнить обновление плагинов системного агента
namespace="production"
monq_agent=$(kubectl get po -n ${namespace} -l app=pl-monq-agent -o=jsonpath='{.items[0].metadata.name}')
plugins="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.1/${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