Перейти к содержанию

Инструкция по обновлению экземпляра ПО

Обновление Platform UI включает в себя изменение версии образов в конфигурационных файлах и применение изменений с помощью Helm.

Подготовка

Проверьте наличие необходимых утилит. Убедитесь, что у вас установлены kubectl и helm. Для этого выполните следующие команды: 

kubectl version

helm version

Если вы видите ошибки, установите недостающие утилиты.

Скачайте актуальные файлы конфигурации. Убедитесь, что у вас есть актуальные версии файлов cm_values_back.yaml и cm_values_front.yaml из архива cluster_manager.zip.

Изменение версии образов

  • Откройте файлы конфигурации.

cm_values_back.yaml — для настройки компонентов API и backend.

cm_values_front.yaml — для настройки компонентов фронта.

cm_values_documentation.yaml — для настройки компонентов документации.

  • Измените версии образов.

service.image.repository: <путь_к_репозиторию>

service.image.tag: <текущая_версия>

Обновите значение service.image.tag на новую версию, которую вы хотите установить.

Обновление параметров развертывания

При переходе с версии 2.1.1 и меньше на текущую версию Platform UI необходимо изменить шаблон переменной в cm_values_back.yaml. В новой версии шаблон переменной service.extra_vars.KEYCLOAK_ISSUER_URI выглядит следующим образом:

{PROTOCOL}://{DOMAIN_OR_IP_WITH_PORT}/auth/realms/dev/protocol/openid-connect/certs

При версии Keycloak меньше 17:

{PROTOCOL}://{DOMAIN_OR_IP_WITH_PORT}/auth/realms/dev/protocol/openid_connect/certs

Применение обновлений

Обновите модули с помощью Helm. Выполните следующие команды для применения изменений: 

helm upgrade cm-cluster-manager ./cm-cluster-manager --namespace $BACKEND_NAMESPACE --debug -f cm_values_back.yaml

helm upgrade gbcm-ui ./gb-cm-ui --namespace $UI_NAMESPACE --debug -f cm_values_front.yaml

helm upgrade gbcm-documentation ./gb-cm-documentation --namespace $DOC_NAMESPACE --debug -f cm_values_documentation.yaml

Обновление ролей Keycloak

Обновление ролей Keycloak необходимо выполнить при переходе с версии Platform UI 1.9.4 и ниже на текущий релиз. Актуальная конфигурация ролей Keycloak прилагается к инструкции.

Конфигурация ролей Keycloak описана в разделе «Конфигурация Keycloak» текущего руководства.

После обновления ролей Keycloak в файле client.json изменяется параметр redirectUris на справочный. Нужно заменить его на актуальный вручную.

Проверка обновления

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

kubectl get pods -n $BACKEND_NAMESPACE

kubectl get pods -n $UI_NAMESPACE

Убедитесь, что все поды находятся в состоянии Running или Completed.

Проверьте логи

Если какие-либо поды не запустились, проверьте их логи для устранения возможных ошибок: 

kubectl logs <имя_пода\> -n $BACKEND_NAMESPACE