API поиска | On-Premise | 2GIS Documentation
On-Premise

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

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

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

    Чтобы загрузить артефакты только для сервиса Search API, добавьте параметр --services=search после команды pull. Без этого параметра по умолчанию будут загружены артефакты для всех сервисов.

    См. справку по командам и аргументам 2GIS CLI.

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

    Важно

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

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

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

    • Чтобы обновить только сервис или сервис и данные:

      helm upgrade --version=1.24.0 --atomic --values ./values-search.yaml search-api 2gis-on-premise/search-api
      
    • Чтобы обновить только данные, подставьте текущую установленную версию комплекса On-Premise в параметр --version:

      helm upgrade --version=VERSION --atomic --values ./values-search.yaml search-api 2gis-on-premise/search-api
      
  5. Проверьте работоспособность сервиса.

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

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

    Чтобы загрузить артефакты только для сервиса Catalog APIs API, добавьте параметр --services=catalog после команды pull. Без этого параметра по умолчанию будут загружены артефакты для всех сервисов.

    См. справку по командам и аргументам 2GIS CLI.

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

    Важно

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

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

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

    • Чтобы обновить только сервис или сервис и данные:

      helm upgrade --version=1.24.0 --atomic --values ./values-catalog.yaml catalog-api 2gis-on-premise/catalog-api
      
    • Чтобы обновить только данные, подставьте текущую установленную версию комплекса On-Premise в параметр --version:

      helm upgrade --version=VERSION --atomic --values ./values-catalog.yaml catalog-api 2gis-on-premise/catalog-api
      
  5. Проверьте работоспособность сервиса.

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

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

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