› ›

使用配置文件管理插件

仅限 Docker

此功能仅适用于官方 Elasticsearch Docker 镜像。其他 Elasticsearch 发行版将不会以插件配置文件启动。

如果您使用 Docker 运行 Elasticsearch，则可以使用声明性配置文件来管理插件。Elasticsearch 启动时，会将文件中的插件与当前已安装的插件进行比较，并根据需要添加或删除插件。当您升级 Elasticsearch 本身时，Elasticsearch 也会升级官方插件。

该文件名为 elasticsearch-plugins.yml，必须放置在 Elasticsearch 配置目录中，与 elasticsearch.yml 并列。以下是一个示例

plugins:
  - id: analysis-icu
  - id: repository-azure
  - id: custom-mapper
    location: https://example.com/archive/custom-mapper-1.0.0.zip

此示例安装了官方的 analysis-icu 和 repository-azure 插件，以及一个非官方插件。每个插件都必须提供一个 id。非官方插件还必须提供一个 location。这通常是一个 URL，但也支持 Maven 坐标。下载的插件名称必须与配置文件中的 ID 匹配。

虽然 Elasticsearch 在下载插件时会尊重标准 Java 代理系统属性，但您也可以在配置文件中明确配置要使用的 HTTP 代理。例如

plugins:
  - id: custom-mapper
    location: https://example.com/archive/custom-mapper-1.0.0.zip
proxy: proxy.example.com:8443