Обновление API для работы с навигацией

Вы можете обновить сервисы навигации как вместе с их данными, так и без их обновления. Чтобы загрузить только данные, достаточно обновить сервис Navi-Castle. В остальных случаях обновите все необходимые сервисы навигации.

Обновление сервиса Navi-Castle

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

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

   Чтобы загрузить артефакты только для сервисов навигации, добавьте параметр --services после команды pull со следующими значениями:

   • --services=navi для загрузки артефактов сервисов навигации;
   • --services=navi,navi-restrictions для загрузки артефактов сервисов навигации и данных о перекрытиях (если не установлен Restrictions API);
   • --services=navi-restrictions для загрузки только данных о перекрытиях (если не установлен Restrictions API).

   Без этого параметра по умолчанию будут загружены артефакты для всех сервисов. См. справку по командам и аргументам 2GIS CLI.

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

   Важно

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

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

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

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

     helm upgrade --version=1.21.0 --atomic --values ./values-castle.yaml navi-castle 2gis-on-premise/navi-castle
     

   • Чтобы обновить только данные, подставьте текущую установленную версию комплекса On-Premise в параметр --version:

     helm upgrade --version=VERSION --atomic --values ./values-castle.yaml navi-castle 2gis-on-premise/navi-castle
     

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

Обновление сервиса Navi-Back

Выполните шаги ниже для каждого установленного инстанса Navi-Back:

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

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

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

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

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

   helm upgrade --version=1.21.0 --atomic --values ./values-back.yaml navi-back 2gis-on-premise/navi-back
   

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

Обновление сервиса Navi-Router

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

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

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

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

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

   helm upgrade --version=1.21.0 --atomic --values ./values-router.yaml navi-router 2gis-on-premise/navi-router
   

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

Обновление сервиса Navi-Front

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

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

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

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

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

   helm upgrade --version=1.21.0 --atomic --values ./values-front.yaml navi-front 2gis-on-premise/navi-front
   

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

Обновление сервиса Distance Matrix Async API

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

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

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

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

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

   helm upgrade --version=1.21.0 --atomic --values ./values-navi-async-matrix.yaml navi-async-matrix 2gis-on-premise/navi-async-matrix
   

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

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

1. (Рекомендуется) Выполните резервное копирование данных, которые использует сервис.

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

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

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

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

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

   helm upgrade --version=1.21.0 --atomic --values ./values-restrictions.yaml navi-restrictions 2gis-on-premise/navi-restrictions
   

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