#Обновление

В этом документе приведены инструкции по обновлению Alauda Hyperflux до новой версии.

#Стандартные шаги обновления

Для большинства обновлений версий (за исключением перехода с v1.2.0 на v1.2.1) вы можете просто выполнить следующие шаги в консоли ACP:

1. Загрузите новый пакет плагина в ACP Marketplace.
   Загрузите пакет так же, как при первоначальной установке.
   После завершения загрузки подождите примерно 10–15 минут, чтобы платформа автоматически синхронизировала информацию о новой версии.
2. Проверьте наличие новой версии в Marketplace.
   Перейдите в Administrator / Marketplace / Upload Packages.
   Переключитесь на вкладку Cluster Plugin и убедитесь, что для плагина Hyperflux отображается номер новой версии.
3. Выполните операцию обновления на кластере.
   Перейдите в Administrator / Clusters / Clusters.
   Найдите кластер, в котором установлен плагин Hyperflux; в записи кластера будет отображаться иконка обновления.
   Нажмите, чтобы перейти к деталям кластера, и переключитесь на вкладку Features.
   На карточке плагина Hyperflux нажмите кнопку Upgrade и подтвердите операцию.
4. Проверьте результат обновления.
   После завершения обновления убедитесь, что номер версии обновился на вкладке Features.
   Проверьте нормальную работу через мониторинг статуса плагина или логи.

#Обновление с v1.2.0 на v1.2.1 (особый случай)

ВАЖНО: При обновлении с v1.2.0 на v1.2.1 база знаний будет переинициализирована. Вы обязаны вручную сделать резервную копию и восстановить базу данных, чтобы избежать потери данных.

#Шаг 1: Резервное копирование базы знаний

Перед обновлением выполните следующие команды:

# Получить имя pod PostgreSQL (если используется встроенная база данных)
kubectl -n cpaas-system get pod | grep postgre-vec

# Сделать дамп базы данных в файл
kubectl -n cpaas-system exec -it <postgre-vec-xxx> -- pg_dump -U postgres -d <your-database-name> -F c -f /tmp/hyperflux_backup.dump

# Скопировать файл дампа на локальную машину
kubectl -n cpaas-system cp <postgre-vec-xxx>:/tmp/hyperflux_backup.dump ./hyperflux_backup.dump

#Шаг 2: Выполнить обновление

Следуйте Стандартным шагам обновления, описанным выше, чтобы обновить версию плагина через консоль ACP.

#Шаг 3: Восстановление базы знаний

После завершения обновления восстановите данные:

# Получить имя нового pod PostgreSQL
kubectl -n cpaas-system get pod | grep postgre-vec

# Скопировать файл резервной копии обратно в pod
kubectl -n cpaas-system cp ./hyperflux_backup.dump <postgre-vec-xxx>:/tmp/hyperflux_backup.dump

# Восстановить базу данных из файла дампа
kubectl -n cpaas-system exec -it <postgre-vec-xxx> -- pg_restore -U postgres -d <your-database-name> /tmp/hyperflux_backup.dump

# (Опционально) Обновить конфигурацию, если изменились имя базы данных/коллекции
kubectl -n cpaas-system edit configmap smart-doc-config
# При необходимости обновите поля `PG_CONN_DB` и `PG_COLLECTION_NAME`.

Дождитесь перезапуска pod-ов Alauda Hyperflux и убедитесь, что база знаний успешно восстановлена.