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

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

Обновление платформы проходит в несколько этапов:

• Перенос настроек в файлы конфигурации новой версии
• Загрузка образов для сервисов
• Снятие дампа базы данных
• Остановка сервисов старой версии
• Запуск сервисов новой версии

примечание

Все пути к файлам и папкам указаны относительно директории setup. Все команды выполняются в системной консоли из этой директории.

1. Скопируйте файл лицензии face_sdk.lic из директории setup в аналогичную директорию нового дистрибутива.

2. Перенесите секреты из файла ./cfg/platform.secrets.json в аналогичный файл в новом дистрибутиве. Это необходимо, чтобы сохранить их локально и обеспечить возможность их использования при развертывании.

3. Перенесите конфигурацию сервисов из старого дистрибутива, сравнив содержимое следующих файлов в обеих версиях:

   • ./cfg/image-api.values.yaml
   • ./cfg/matcher.values.yaml
   • ./cfg/platform.values.yaml
   • ./cfg/platform-ui.values.yaml
   • ./cfg/license-server.settings.cfg

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

4. Обновите образы, расположенные локально, выполнив команду:

   ./cli.sh generic load-images

5. Сделайте бэкап базы данных:

   ./cli.sh platform db-backup - <postgres_root_user> <dump_path>

   В переменную <root_postgres_user> запишите значение переменной postgres-root-credentials.user, содержащейся в файле ./cfg/platform.secrets.json.

   В переменную <dump_path> запишите абсолютный путь до файла формата sql, используемого для дампа (можно создать вручную). Также рекомендуем заархивировать директорию /kv.

6. Перед запуском новой версии платформы остановите предыдущую версию, выполнив команды:

   ./cli.sh image-api uninstall
   ./cli.sh matcher uninstall
   ./cli.sh platform uninstall
   ./cli.sh platform-ui uninstall

Оставшиеся команды выполняйте из директории setup нового дистрибутива.

7. Пересоздайте секреты:

   ./cli.sh platform install-secrets

8. Разверните модули платформы:

   ./cli.sh image-api install
   ./cli.sh matcher install
   ./cli.sh platform install
   ./cli.sh platform-ui install

9. Для удобного отслеживания процесса развертывания откройте еще одну вкладку терминала и выполните команду:

   watch 'kubectl get pods'

   Наличие у всех под (pods) статуса Running означает, что платформа запущена.

Удаление предыдущей версии платформы

1. Перейдите в папку <distribution_folder>/setup развернутой версии платформы и остановите платформу:

   ./cli.sh platform uninstall
   ./cli.sh image-api uninstall

2. Убедитесь, что все контейнеры сервисов остановлены:

   watch 'kubectl get pods'

   Статус сервисов из состояния "Running" должен перейти в состояние "Terminating". В результате, все сервисы должны пропасть из отображаемой таблицы.

3. Удалите развернутый Kubernetes-кластер:

   ./cli.sh smc uninstall

4. Удалите вспомогательные файлы Kubernetes-кластера:

   sudo rm -rf ~/.kube/

примечание

При удалении платформы вся база данных сохраняется в директории /kv/pgdata. Для дальнейшего использования базы в процессе установки новой версии платформы укажите те же авторизационные данные и имя базы данных. В противном случае, выполните команду:

./cli.sh platform db-reset