当您需要使用自定义插件时,可通过阿里云Elasticsearch(简称ES)的自定义插件上传与安装功能,在对应实例中上传并安装自定义插件。本文介绍具体的操作方法。

前提条件

  • 准备待上传的插件,并确保插件的可用性和安全性。

    插件文件格式要求:文件名只能包含大写字母、小写字母、数字、连接线(-)或点(.),长度为8~128位。文件后缀名必须是.zip。

    说明 建议在上传插件前,先在本地自建ES集群(与阿里云ES相同版本)上进行测试,成功后再上传至阿里云ES上,具体操作步骤请参见Writing an Elasticsearch Plugin
  • 如果您需要上传自定义的SQL插件,请确保已经将阿里云ES实例的YML文件中的xpack.sql.enabled参数设置为false

    具体配置方法请参见修改YML参数配置

操作步骤

  1. 登录阿里云Elasticsearch控制台
  2. 在顶部菜单栏处,选择地域。
  3. 在左侧导航栏单击Elasticsearch实例,再在实例列表中单击目标实例ID。
  4. 在左侧导航栏,单击插件配置
  5. 插件配置页面,切换到自定义插件列表页签,单击上传
    上传自定义插件入口
    警告 上传自定义插件操作会触发阿里云ES实例重启,并且插件本身可能影响实例的稳定性,请务必保证自定义插件的可用性和安全性。
  6. 插件上传对话框中,单击添加多个文件或将多个文件拖放到此区域,选择待上传的插件,单击打开。
    您也可以将自定义的插件文件直接拖放到指定区域,完成添加。如下图成功添加了文件名为elasticsearch-sql-6.7.0.0.zip的自定义插件。插件上传对话框
    说明 使用同样的方式可添加多个自定义插件。
  7. 阅读并勾选对话框中的注意事项,单击上传安装
    上传安装插件会触发阿里云ES实例重启。重启成功后,如果在自定义插件列表中看到您上传的插件,且状态显示为已安装,表示插件上传并安装成功。安装成功的插件

    如果您不再使用此插件,可单击插件右侧的卸载,卸载此插件。详细操作方法及注意事项请参见安装或卸载系统默认插件

    注意
    • 阿里云ES升级时插件不会自动升级更新,需要重新上传。
    • 自定义插件不能访问外网。