上传与安装自定义插件

使用限制

阿里云Elasticsearch不支持上传带任意权限类的插件，例如elasticsearch-analysis-hanlp插件。

前提条件

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

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

  注意 建议在上传插件前，先在本地自建Elasticsearch集群（与阿里云Elasticsearch相同版本）上进行测试，成功后再进行上传，具体操作步骤请参见Installing Plugins。
• 如果您需要上传自定义的SQL插件，请确保已经将阿里云Elasticsearch实例的YML文件中的xpack.sql.enabled参数设置为false。

  具体配置方法请参见配置YML参数。

操作步骤

1. 登录阿里云Elasticsearch控制台。
2. 在左侧导航栏，单击Elasticsearch实例。
3. 进入目标实例。
   1. 在顶部菜单栏处，选择资源组和地域。
   2. 在左侧导航栏，单击Elasticsearch实例，然后在Elasticsearch实例中单击目标实例ID。
4. 在左侧导航栏，单击插件配置。
5. 在插件配置页面，单击自定义插件列表页签，再单击上传。
   

   警告 上传自定义插件操作会触发实例重启，并且插件本身可能影响实例的稳定性，请务必保证自定义插件的可用性和安全性，建议在业务低峰期进行操作。
6. 在上传插件对话框中，单击添加多个文件或将多个文件拖放到此区域，选择待上传的插件，单击打开。
   您也可以将自定义的插件文件直接拖放到指定区域，完成添加。如下图成功添加了文件名为elasticsearch-sql-6.7.0.0.zip的自定义插件。
7. 阅读并勾选对话框中的注意事项，单击上传安装。
   上传安装插件会触发实例重启，建议业务低峰期进行。重启成功后，如果在自定义插件列表中看到您上传的插件，且状态显示为已安装，表示插件上传并安装成功。

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

   注意

   • 在上传与安装自定义插件时，如果出现控制台报错、变更卡住、无法验证通过或其他异常问题，可参见自定义插件安装错误的排查与解决方法进行排查解决。
   • 阿里云Elasticsearch升级时插件不会自动升级更新，需要重新上传。
   • 自定义插件不能访问外网。