mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-04-25 07:37:19 -04:00
a4e0d9b9dd
Including extracting static content from migration/index, so the template would be as light as possible. The reason for this work is because the gradle task `generateReleaseNotes` was not correctly adding new links and imports to the migrations/index and that caused documentation to fail building for 8.3.0.
31 lines
1.4 KiB
Text
31 lines
1.4 KiB
Text
[[breaking-changes]]
|
|
= Migration guide
|
|
|
|
This section discusses the changes that you need to be aware of to migrate
|
|
your application to {version}. For more information about what's new in this
|
|
release, see the <<release-highlights>> and <<es-release-notes>>.
|
|
|
|
As {es} introduces new features and improves existing ones, the changes
|
|
sometimes make older settings, APIs, and parameters obsolete. We typically
|
|
deprecate obsolete functionality as part of a release. If possible, we support
|
|
the deprecated functionality for several subsequent releases before removing it.
|
|
This enables applications to continue working unchanged while you prepare to
|
|
migrate away from the deprecated functionality.
|
|
|
|
To get the most out of {es} and facilitate future upgrades, we strongly
|
|
encourage migrating away from using deprecated functionality as soon as
|
|
possible.
|
|
|
|
To give you insight into what deprecated features you're using, {es}:
|
|
|
|
- Returns a `Warn` HTTP header whenever you
|
|
submit a request that uses deprecated functionality.
|
|
- <<deprecation-logging, Logs deprecation warnings>> when
|
|
deprecated functionality is used.
|
|
- <<migration-api-deprecation, Provides a deprecation info API>>
|
|
that scans a cluster's configuration
|
|
and mappings for deprecated functionality.
|
|
|
|
For more information about {minor-version},
|
|
see the <<release-highlights>> and <<es-release-notes>>.
|
|
For information about how to upgrade your cluster, see <<setup-upgrade>>.
|