Migrate from Elasticsearch 8 to 9

Proprietary

This recipe performs a comprehensive migration from Elasticsearch 8 to Elasticsearch 9, addressing breaking changes, API removals, deprecations, and required code modifications. Migrates to the co.elastic.clients:elasticsearch-rest5-client transport (Apache HttpClient 5.x), which is Elastic's recommended path for the 9.x line. To retain the legacy Apache HttpClient 4.x transport, run io.moderne.elastic.elastic9.MigrateToElasticsearch9LegacyTransport instead.

io.moderne.elastic.elastic9.MigrateToElasticsearch9
mod run . --recipe=io.moderne.elastic.elastic9.MigrateToElasticsearch9

Install it once from Recipe actions, then run it on every repository under the current directory. New to the Moderne CLI? Set it up.

Recipe list

It runs these recipes, in this order.

  1. Migrate from Elasticsearch 8 to 9 (API renames, transport-agnostic)
  2. Change type RestClient to Rest5Client
  3. Change type RestClientBuilder to Rest5ClientBuilder
  4. Change type org.elasticsearch.client.Request to co.elastic.clients.transport.rest5_client.low_level.Request
  5. Change type org.elasticsearch.client.Response to co.elastic.clients.transport.rest5_client.low_level.Response
  6. Change type org.elasticsearch.client.ResponseException to co.elastic.clients.transport.rest5_client.low_level.ResponseException
  7. Change type org.elasticsearch.client.ResponseListener to co.elastic.clients.transport.rest5_client.low_level.ResponseListener
  8. Change type org.elasticsearch.client.RequestOptions to co.elastic.clients.transport.rest5_client.low_level.RequestOptions
  9. Change type org.elasticsearch.client.RequestLogger to co.elastic.clients.transport.rest5_client.low_level.RequestLogger
  10. Change type org.elasticsearch.client.Node to co.elastic.clients.transport.rest5_client.low_level.Node
  11. Change type org.elasticsearch.client.NodeSelector to co.elastic.clients.transport.rest5_client.low_level.NodeSelector
  12. Change type org.elasticsearch.client.HasAttributeNodeSelector to co.elastic.clients.transport.rest5_client.low_level.HasAttributeNodeSelector
  13. Change type org.elasticsearch.client.PreferHasAttributeNodeSelector to co.elastic.clients.transport.rest5_client.low_level.PreferHasAttributeNodeSelector
  14. Change type org.elasticsearch.client.DeadHostState to co.elastic.clients.transport.rest5_client.low_level.DeadHostState
  15. Change type org.elasticsearch.client.Cancellable to co.elastic.clients.transport.rest5_client.low_level.Cancellable
  16. Change type org.elasticsearch.client.WarningsHandler to co.elastic.clients.transport.rest5_client.low_level.WarningsHandler
  17. Change type org.elasticsearch.client.WarningFailureException to co.elastic.clients.transport.rest5_client.low_level.WarningFailureException
  18. Change type org.elasticsearch.client.HttpAsyncResponseConsumerFactory to co.elastic.clients.transport.rest5_client.low_level.HttpAsyncResponseConsumerFactory
  19. Change type org.elasticsearch.client.HttpGetWithEntity to co.elastic.clients.transport.rest5_client.low_level.HttpGetWithEntity
  20. Change type org.elasticsearch.client.HttpDeleteWithEntity to co.elastic.clients.transport.rest5_client.low_level.HttpDeleteWithEntity
  21. Change type org.elasticsearch.client.LanguageRuntimeVersions to co.elastic.clients.transport.rest5_client.low_level.LanguageRuntimeVersions
  22. Change type RestClientTransport to Rest5ClientTransport
  23. Change type RestClientOptions to Rest5ClientOptions
  24. Change type RestClientHttpClient to Rest5ClientHttpClient
  25. Change type co.elastic.clients.transport.rest_client.SafeResponseConsumer to co.elastic.clients.transport.rest5_client.SafeResponseConsumer
  26. Change type co.elastic.clients.transport.rest_client.MultiBufferEntity to co.elastic.clients.transport.rest5_client.MultiBufferEntity
  27. Add comment to import statement matching org.elasticsearch.client.HeapBufferedAsyncResponseConsumer
  28. Add comment to import statement matching org.elasticsearch.client.PersistentCredentialsAuthenticationStrategy
  29. Add Gradle or Maven dependency co.elastic.clients:elasticsearch-rest5-client:9.x
  30. Remove a Gradle or Maven dependency org.elasticsearch.client:elasticsearch-rest-client