← All recipes
Moderne licensed

Migrate from Elasticsearch 8 to 9

Recipe IDio.moderne.elastic.elastic9.MigrateToElasticsearch9
Artifactio.moderne.recipe:rewrite-elastic

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.

Composite recipeelasticsearchmigrationProprietary

Usage

This recipe has no required configuration options. You’ll need the Moderne CLI configured before running the command below.

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

If the recipe isn’t available locally, install it with:

mod config recipes jar install io.moderne.recipe:rewrite-elastic:0.8.2

Definition

This recipe runs the following recipes in order.

Data tables

Structured output this recipe can produce.

  • Source files that had resultsSource files that were modified by the recipe run.org.openrewrite.table.SourcesFileResults
  • Source files that had search resultsSearch results that were found during the recipe run.org.openrewrite.table.SearchResults
  • Source files that errored on a recipeThe details of all errors produced by a recipe run.org.openrewrite.table.SourcesFileErrors
  • Recipe performanceStatistics used in analyzing the performance of recipes.org.openrewrite.table.RecipeRunStats