elasticsearch/docs/reference/migration/migrate_8_0/plugin-changes.asciidoc
Rory Hunter d2dbef5063
Convert repository plugins to modules (#81870)
Closes #81652.

Convert the `repository-azure`, `repository-gcs` and `repository-s3`
plugins into modules, so that they are always included in the
Elasticsearch distribution. Also change plugin installation, removal
and syncing so that attempting to add or remove these plugins still
succeeds but is now a no-op.
2022-01-10 10:45:42 +00:00

48 lines
1.9 KiB
Text

[discrete]
[[breaking_80_plugin_changes]]
==== Plugin changes
//NOTE: The notable-breaking-changes tagged regions are re-used in the
//Installation and Upgrade Guide
//tag::notable-breaking-changes[]
TIP: {ess-skip-section}
.The S3, GCS and Azure repository plugins are now included in Elasticsearch
[%collapsible]
====
*Details* +
In previous versions of {es}, in order to register a snapshot repository
backed by Amazon S3, Google Cloud Storge (GCS) or Microsoft Azure Blob
Storage, you first had to install the corresponding Elasticsearch plugin,
for example `repository-s3`. These plugins are now included in {es} by
default.
*Impact* +
You no longer need to install the following plugins, and not should attempt
to do so.
* `repository-azure`
* `repository-gcs`
* `repository-s3`
{es} and the `elasticsearch-plugin` CLI tool have been changed to tolerate
attempted installation and removal of these plugins in order to avoid
breaking any existing automation. In the future, attempting to install
these plugins will be an error.
Specifically, the `elasticsearch-plugin` CLI tool will not fail if you
attempt to install any of the above plugins, and will instead print a
warning and skip the plugins. If any of these plugins are already
installed, for example because you installed them when running an older
version of {es}, then you can still remove them with
`elasticsearch-plugin`. Attempting to remove them if they are not installed
will succeed but print a warnings.
If you run {es} using Docker and you are managing plugins using a
{plugins}/manage-plugins-using-configuration-file.html[configuration file], then when
{es} first starts after you upgrade it, it will remove the above plugins if
they already installed. If any of these plugins are specified in your
configuration file, {es} will ignore them and emit a warning log message.
====
//end::notable-breaking-changes[]