当您上传插件文件后，您可以安装自定义插件。

注意事项

• 安装自定义插件会触发重启集群，建议在业务低峰期安装插件。
• 在实例上安装自定义插件，自定义插件本身可能会影响实例的稳定性，请务必先在本地进行安装测试验证，保证插件的可用性和安全性。
• 您在上传与安装自定义插件时，如果出现上传失败、安装卡住或者卸载卡住等异常问题，可参见自定义插件安装异常处理方案进行排查解决。

前提条件

在实例安装插件会触发集群重启，如果插件存在代码缺陷，将会导致实例节点安装后启动失败，同时影响集群的稳定性。任何需要上传并安装到云搜索服务实例中的自定义插件，都需要提前在本地自建的 Elasticsearch 服务中进行安装测试，只有安装测试通过后的插件才可以上传并安装到云搜索服务实例。

1. 在本地 Elasticsearch 服务中安装插件。
   命令为：./bin/elasticsearch-plugin install file:///path-to-your-plugins.zip
2. 重启集群加载插件。
3. 查询插件是否安装成功。
   执行GET /_cat/plugins?v命令，获取插件信息，判断自定义插件是否安装成功。

安装自定义插件

当您上传自定义插件后，您可以安装插件。

1. 登录云搜索服务控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 在实例列表 v2页面，单击目标实例名称。
4. 在左侧导航栏选择实例管理 > 插件管理，然后单击自定义插件页签。
5. 在自定义插件页签下，单击批量安装/升级/卸载。
6. 在目标插件的操作列中勾选安装并选择需要安装的插件版本，然后单击批量提交。
   支持同时勾选多个自定义插件，进行批量安装操作。
   
7. 在批量提交对话框，查看安装插件的提示信息，然后单击确定。

   说明

   • 安装自定义插件会触发重启集群，建议在业务低峰期安装插件。
   • 如果您当前安装的插件已经安装，则系统会先卸载历史版本插件再进行新版本插件的安装。
   • 自定义插件本身可能会影响实例的稳定性，请务必保证自定义插件的可用性和安全性。
   
8. 查看自定义插件安装进度。
   执行插件安装操作后，目标插件状态显示为安装中。当显示插件的目标版本后，表示插件安装成功。
   

升级自定义插件

每个插件最多支持上传 5 个不同版本的插件文件，只能安装 1 个版本的插件。插件安装后，您可以根据业务需要升级插件的版本。

1. 登录云搜索服务控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 在实例列表 v2页面，单击目标实例名称。
4. 在左侧导航栏选择实例管理 > 插件管理，然后单击自定义插件页签。
5. 在自定义插件页签下，单击批量安装/升级/卸载。
6. 在目标插件的操作列中，勾选升级并选择需要升级到的目标版本，然后单击批量提交。
   
7. 在批量提交对话框，查看提示信息和升级后的插件版本，然后单击确定。

   说明

   • 安装自定义插件会触发重启集群，建议在业务低峰期安装插件。
   • 如果您当前安装的插件已经安装，则系统会先卸载历史版本插件再进行新版本插件的安装。
   
8. 查看自定义插件升级进度。
   执行插件升级操作后，插件历史版本显示为卸载中，新版本显示为安装中。当插件版本显示为新版本后，则表示插件升级成功。