Миграция на 7.14
В этом разделе обсуждаются изменения, которые необходимо учитывать при миграции приложения в Elasticsearch 7.14.
См. также Что нового в 7.17 и Справочные материалы по выпуску.
Существенные изменения
Следующие изменения в Elasticsearch 7.14 могут повлиять на ваши приложения и помешать их нормальной работе. Перед обновлением до 7.14 ознакомьтесь с этими изменениями и выполните описанные шаги, чтобы смягчить последствия.
Существенные изменения, введенные в не-главных версиях, обычно ограничиваются вопросами безопасности и исправлением ошибок. Значительные изменения в поведении отменяются в не-главном выпуске, а старое поведение поддерживается до следующего основного выпуска. Чтобы узнать, используете ли вы какие-либо устаревшие функции, включите логирование отмены использования.
Изменения кластера
Применяется барьер версий для всех обновлений
Подробности
Если во время поэтапного обновления произойдет сбой, Elasticsearch может преждевременно сделать вывод о завершении обновления и включить функциональность, несовместимую со старыми версиями. В версиях Elasticsearch до 7.14 Elasticsearch принимал старые узлы в кластер после завершения обновления, несмотря на включение несовместимой функциональности, при условии, что старые узлы были из одной основной серии. Начиная с 7.14 Elasticsearch не будет принимать старые узлы в полностью обновлённый кластер.
Последствия
Если во время поэтапного обновления произойдет сбой, и старые узлы не смогут присоединиться к кластеру, необходимо обновить затронутые узлы. После обновления они снова присоединятся к кластеру.
Отмена использования
Следующая функциональность была отменена в Elasticsearch 7.14 и будет удалена в 8.0. Хотя это не окажет немедленного влияния на ваши приложения, мы настоятельно рекомендуем вам выполнить описанные шаги, чтобы обновить свой код после обновления до 7.14.
Значительные изменения в поведении отменяются в не-главном выпуске и старое поведение поддерживается до следующего основного выпуска. Чтобы узнать, используете ли вы какие-либо устаревшие функции, включите логирование отмены использования.
Отмена использования Cross-cluster replication (CCR)
Автоматическое отслеживание удаленных системных индексов устарело.
Подробности
В настоящее время удаленные системные индексы, соответствующие шаблону автоматического отслеживания, автоматически настраиваются как индекс-фолловер, это поведение устарело.
Последствия
В 8.0.0 удаленные системные индексы, соответствующие шаблону автоматического отслеживания, не будут автоматически настраиваться как индекс-фолловер. Для адаптации к этому новому поведению рекомендуется исключить шаблоны, соответствующие системным индексам, таким как .tasks и kibana-*.
Отмена использования основных функций
Настройка cluster.routing.allocation.disk.watermark.enable_for_single_data_node=false устарела.
Подробности
Настройка cluster.routing.allocation.disk.watermark.enable_for_single_data_node никогда не должна быть явно установлена в false. В 8.0 единственным допустимым значением будет true. В будущей версии настройка будет полностью удалена, с тем же поведением, как если бы настройка была true.
Последствия
Если в вашем кластере есть один узел данных, установите cluster.routing.allocation.disk.watermark.enable_for_single_data_node: true, чтобы включить будущее поведение сегодня. Если вы хотите отключить метки дисков, установите cluster.routing.allocation.disk.threshold_enabled: false.
Если в вашем кластере есть несколько узлов данных, настройка cluster.routing.allocation.disk.watermark.enable_for_single_data_node не имеет эффекта, и следует прекратить ее использование.
Отмена использования функций поиска
Параметр geo_bounding_box запроса type устарел.
Подробности
Параметр geo_bounding_box запроса type устарел в версии 7.14.0. Этот параметр является бесполезным и не оказывает никакого влияния на запрос.
Последствия
Прекратите использование параметра type в запросах geo_bounding_box.
Отмена использования функций безопасности
Отключение безопасности по умолчанию в базовых и пробных лицензиях устарело.
Подробности
Функции безопасности Elasticsearch отключены по умолчанию при работе с базовой или пробной лицензией, если xpack.security.enabled не установлено в true. В Elasticsearch 8.0.0 функции безопасности будут включены по умолчанию для всех лицензий, если вы не отключите их явно, установив xpack.security.enabled в false (не рекомендуется).
Перед миграцией на Elasticsearch 8.0.0 необходимо явно установить значение для xpack.security.enabled, иначе Elasticsearch не сможет запуститься. Если вы уже включили функции безопасности, явно установив xpack.security.enabled в true, ваша конфигурация будет сохранена в 8.0.0.
В противном случае на каждом узле вашего кластера включите функции безопасности Elasticsearch, установив xpack.security.enabled в true в elasticsearch.yml. Затем необходимо настроить безопасность транспортного уровня на каждом узле, что требует создания центра сертификации (если у вас его нет), создания сертификатов безопасности узлов и настройки межсетевого взаимодействия. См. настройку базовой безопасности для Elastic Stack для шагов настройки безопасности.
Настройка имени домена с ведущим подчеркиванием устарела.
Подробности
Elasticsearch создает «синтетические» имена домена динамически для сервисов, таких как API-ключи. Эти синтетические имена домена имеют префикс подчеркивание. В настоящее время пользователи могут настраивать имена домена с ведущим подчеркиванием. Это создает путаницу, поскольку имена домена должны быть уникальными для узла.
Последствия
Настройка имени домена с ведущим подчеркиванием устарела. В будущей версии Elasticsearch это приведет к ошибке при запуске, если у любого настроенного пользователем домена есть имя с ведущим подчеркиванием.
© 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.14.html