环境准备
背景: 阿里云ES文档介绍支持上传与安装自定义插件, 在配置自定义插件的过程中,会遇到各种各样的问题, 本篇以elasticsearch-analysis-hanlp插件为例介绍几种常见的报错问题, 注意: 阿里云Elasticsearch不支持上传带任意权限类的插件, elasticsearch-analysis-hanlp就是其一,本文也作为验证来核实。
1.插件下载
准备待上传的插件,并确保插件的可用性和安全性, 本文以elasticsearch-analysis-hanlp-7.10.0版本为例, 插件点击下载 其他版本
2.创建阿里云集群(本文示例为7.10版本的ES集群)
配置步骤
1.准备插件
下载插件到本地后解压查看下文件内容(注意解压后不是一个目录下多个文件,直接就是文件列表)
2.解压文件
修改配置文件将plugin-security.policy里面的 permission java.io.FilePermission ********, "read,write,delete"; 两行注释或者删掉(原因: 阿里云Elasticsearch不支持上传带任意权限类的插件)
3.重新打包
然后重新打包如下,注意打包方式是全选插件文件
4.上传安装
登录阿里云ES控制台,在对应集群的自定义插件位置上传安装,然后等待集群变更完成
5.集群变更
结论: 集群变更卡主,根据报错日志判断说明目前7.10版本ES集群确实不支持该权限类插件, 中断变更,完成卸载
常见问题
1.插件存在安全风险
报错: 上传后点击"上传安装"时报错 如附件
原因: 权限配置校验不通过
解决: 解压文件修改重新打包
2.缺少插件描述文件
报错: 上传后点击"上传安装"时报错 如附件
原因: 插件包打包的时候多了一层目录
解决: 解压插件包, 会得到一个目录, 报错原因是因为多了一层目录,需要进入这个目录下, 全选各个文件, 直接打包
3.插件如何更新
插件更新目前只能先卸载之前上传的插件,然后重新上传安装新的插件使用
4.上传安装后看不到自定义插件
上传安装后会触发集群实例变更重启,需要等待集群变更完成后再刷新查看下(卸载同理)
5.插件版本不一致
下载使用的插件需要和阿里云ES集群版本保持一致,否则无法兼容
其他
其他注意事项也可参考 自定义插件安装错误的排查与解决方法