Миграция на 7.17
В этом разделе обсуждаются изменения, о которых следует помнить при миграции приложения в Elasticsearch 7.17.
См. также Что нового в 7.17 и Справочные заметки.
Существенные изменения
Следующие изменения в Elasticsearch 7.17 могут повлиять на ваши приложения и помешать их нормальной работе. Перед обновлением до 7.17 ознакомьтесь с этими изменениями и выполните описанные действия для минимизации последствий.
Изменения в пакетировании
Пакет установщика Windows MSI больше недоступен.
Подробности
Мы больше не выпускаем пакеты установщиков Windows MSI для Elasticsearch. Эти пакеты ранее выпускались в бета-версии и не получили широкого распространения.
Последствия
Для установки Elasticsearch на Windows используйте .zip архивный пакет вместо этого.
Устаревшие функции
В Elasticsearch 7.17 были устаревши функции, которые будут удалены в версии 8.0. Хотя это не окажет немедленного влияния на ваши приложения, мы настоятельно рекомендуем выполнить описанные шаги по обновлению кода после обновления до 7.17.
Существенные изменения в поведении устаревают в мажорной версии, а старое поведение поддерживается до следующей мажорной версии. Чтобы узнать, используете ли вы какие-либо устаревшие функции, включите журналирование устаревших функций.
Устаревание настроек кластера и узлов
Устаревание хранилищ доверенных сертификатов без записей
Подробности
Использование хранилищ доверенных сертификатов, не содержащих записей доверенных сертификатов, устарело. Различные *.ssl.truststore.path настройки (например, xpack.security.transport.ssl.truststore.path или xpack.http.ssl.truststore.path) могут использоваться для настройки набора "якорей доверия" для проверки SSL-сертификатов. В Elasticsearch версии 7 и ранее разрешалось настраивать хранилище доверенных сертификатов, не содержащее никаких якорей доверия (то есть оно было пустым или содержало только записи "приватный ключ"). В Elasticsearch версии 8 и выше хранилище truststore.path без записей доверенных сертификатов больше не поддерживается и вызовет ошибку. Данная конфигурация устарела в Elasticsearch версии 7.17.
Последствия
Чтобы избежать предупреждений об устаревании, удалите все хранилища доверенных сертификатов, не содержащие записей доверенных сертификатов.
Устаревание настроек DLS
Подробности
Две настройки, доступные в последних версиях 7.17, недоступны в следующей мажорной версии. Более новые версии 7.17 по умолчанию используют более строгие правила безопасности уровня документа (DLS), и следующие настройки можно использовать для отключения этих более строгих правил DLS: xpack.security.dls.force_terms_aggs_to_exclude_deleted_docs.enabled и xpack.security.dls.error_when_validate_query_with_rewrite.enabled. Более новые версии следующей мажорной версии Elasticsearch также используют более строгие правила DLS, но не позволяют использовать менее строгие правила.
Последствия
Чтобы избежать предупреждений об устаревании, удалите эти настройки из elasticsearch.yml.
Устаревание сопоставлений
Устарели форматы дат с использованием верблюжьего случая.
Подробности
Использование форматов дат с использованием верблюжьего случая устарело и будет удалено в Elasticsearch 8.0.0.
Вместо этого следует использовать соответствующий формат со змеиным случаем.
Последствия
Чтобы избежать предупреждений об устаревании, прекратите использование формата с верблюжьим случаем.
© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/migrating-7.17.html
