OpenSearch: Устаревание процессов и функций

Под устареванием в OpenSearch понимаются процессы и функции, которые находятся в процессе упразднения и (возможно) замены на более новые.

Table of Contents

Как правило, функция не исчезает из одной версии в другую без предупреждения. Обычно это происходит в нескольких версиях. При использовании устаревшей функции в промежуточных версиях она будет продолжать работать как прежде, но при этом будут выдаваться предупреждения о том, что данная функция должна исчезнуть в будущем.

Как это работает

Существует несколько способов узнать, какие функции были устаревшими, в том числе: журналы устаревания, чтение документации на страницах разрушения и внимание к предупреждениям.

В журнале устаревания:

{"type": "deprecation", "timestamp": "2023-01-16T12:50:11,263+0000", "level": "WARN", "component": "o.e.d.r.a.d.RestDeleteAction", "cluster.name": "docker-cluster", "node.name": "es01", "cluster.uuid": "VGTYFgunQ_STTKVz6YHAGg", "node.id": "wh5J7TJ-RD-pJE4JOUjVpw",  "message": "[types removal] Specifying types in document index requests is deprecated, use the typeless endpoints instead (/{index}/_doc/{id}, /{index}/_doc, or /{index}/_create/{id})."  }

{"type": "deprecation", "timestamp": "2023-01-16T12:50:11,263+0000", "level": "WARN", "component": "o.e.d.r.a.d.RestDeleteAction", "cluster.name": "docker-cluster", "node.name": "es01", "cluster.uuid": "VGTYFgunQ_STTKVz6YHAGg", "node.id": "wh5J7TJ-RD-pJE4JOUjVpw", "message": "[types removal] Specifying types in document index requests is deprecated, use the typeless endpoints instead (/{index}/_doc/{id}, /{index}/_doc, or /{index}/_create/{id})." }

Прочитайте документацию по изменениям для каждой версии (используйте меню слева для выбора версии, о которой вы хотите прочитать):

https://opensearch.org/docs/2.11/breaking-changes/

В OpenSearch Dashboards также может появиться предупреждение, если в панели разработки выполняется устаревшая команда:

#! Deprecation: [types removal] Specifying types in document index requests is deprecated, use the typeless endpoints instead (/{index}/_doc/{id}, /{index}/_doc, or /{index}/_create/{id}).

1	#! Deprecation: [types removal] Specifying types in document index requests is deprecated, use the typeless endpoints instead (/{index}/_doc/{id}, /{index}/_doc, or /{index}/_create/{id}).

Важно принять меры в соответствии с этими предупреждениями. Хотя ваше приложение по-прежнему работает, игнорирование предупреждений почти наверняка приведет к сбоям в работе при последующем обновлении.

Deprecation API

Существует API deprecation, с помощью которого можно указать на устаревшие функции на вашем кластере: GET /_migration/deprecations

Однако никогда не следует полагаться только на deprecation API. Если API возвращает данные без проблем, это не означает, что все в вашей конфигурации будет работать при миграции! Это необходимо использовать в дополнение к просмотру журнала поправок и документации по изменениям.