Обновление API для работы с поиском

Обновление сервиса Search API

1. Получите новые артефакты для установки.

   1. Укажите в конфигурационном файле 2GIS CLI:

      • Новую версию компонента api-platform (см. Релизы API-платформы).
      • Версию компонента core, которая требуется для установки новой версии API-платформы (см. подраздел Зависимости в описании релизов API-платформы).

   2. Выполните команду загрузки. Дополнительно вы можете указать следующие флаги:

      • Чтобы обновить только образ сервиса, добавьте флаг --only-apps после команды pull.
      • Чтобы обновить только данные, добавьте флаг --only-data после команды pull.
      • Чтобы обновить и сервис, и данные, выполните команду без добавления флагов выше.

      Дополнительные настройки см. в справке по командам и аргументам 2GIS CLI.

2. Скопируйте путь к новому файлу манифеста из консольного вывода команды и подставьте его в параметр dgctlStorage.manifest в конфигурационном файле values-search.yaml. Подробнее см. в руководстве по установке.

   Важно

   Если при очередном обновлении сервисов поиска вы не хотите импортировать новые данные, используйте тот же манифест, что и в предыдущем импорте. В остальных случаях рекомендуется использовать новый манифест.

3. Ознакомьтесь сo списком критических изменений. Если необходимо, обновите другие настройки в конфигурационном файле values-search.yaml.

4. Выполните команду для обновления сервиса:

   helm upgrade --version=VERSION --atomic --values ./values-search.yaml search-api 2gis-on-premise/search-api

   В параметр --version подставьте версию компонента api-platform:

   • Чтобы обновить только сервис или сервис и данные, используйте новую версию, которую вы указывали в конфигурационном файле 2GIS CLI.
   • Чтобы обновить только данные, подставьте текущую установленную версию.

5. Проверьте работоспособность сервиса.

Обновление сервиса Catalog APIs

1. Получите новые артефакты для установки.

   1. Укажите в конфигурационном файле 2GIS CLI:

      • Новую версию компонента api-platform (см. Релизы API-платформы).
      • Версию компонента core, которая требуется для установки новой версии API-платформы (см. подраздел Зависимости в описании релизов API-платформы).

   2. Выполните команду загрузки. Дополнительно вы можете указать следующие флаги:

      • Чтобы обновить только образ сервиса, добавьте флаг --only-apps после команды pull.
      • Чтобы обновить только данные, добавьте флаг --only-data после команды pull.
      • Чтобы обновить и сервис, и данные, выполните команду без добавления флагов выше.

      Дополнительные настройки см. в справке по командам и аргументам 2GIS CLI.

2. Скопируйте путь к новому файлу манифеста из консольного вывода команды и подставьте его в параметр dgctlStorage.manifest в конфигурационном файле values-catalog.yaml. Подробнее см. в руководстве по установке.

   Важно

   Вы можете настроить процесс импорта новых данных для Catalog APIs. За это отвечают настройки группы importer конфигурационного файла. Если при очередном обновлении сервиса Catalog APIs вы не хотите импортировать новые данные, используйте тот же манифест, что и в предыдущем импорте. В остальных случаях рекомендуется использовать новый манифест.

3. Ознакомьтесь сo списком критических изменений. Если необходимо, обновите другие настройки в конфигурационном файле values-catalog.yaml.

4. Выполните команду для обновления сервиса:

   helm upgrade --version=VERSION --atomic --values ./values-catalog.yaml catalog-api 2gis-on-premise/catalog-api

   В параметр --version подставьте версию компонента api-platform:

   • Чтобы обновить только сервис или сервис и данные, используйте новую версию, которую вы указывали в конфигурационном файле 2GIS CLI.
   • Чтобы обновить только данные, подставьте текущую установленную версию.

5. Проверьте работоспособность сервиса.

Удаление старых наборов данных

Если включено автоматическое создание новых схем при импорте данных об объектах (см. настройки группы importer конфигурационного файла), то предыдущий набор данных становится ненужным после успешного переключения на новый набор. Для экономии места на диске рекомендуется удалять старые наборы данных. Это можно делать автоматически следующим образом:

1. В настройке importer.cleaner.enabled укажите значение true.

2. В настройке importer.cleaner.versionLimit укажите количество старых наборов, которые нужно хранить. Например, 1 означает, что в базе будет сохранено не более 3 схем (текущая, предыдущая и временная, созданная в момент импорта), а все более старые будут удалены. Обратите внимание, что этот лимит не может быть менее 1, так как это сделает невозможным возврат к предыдущей версии при необходимости.