升级版本 - 检索分析服务Elasticsearch版

通过阿里云Elasticsearch（简称ES）的升级版本功能，您可以升级实例的版本或更新升级内核补丁，实现业务的无缝过渡。本文介绍升级的版本限制、升级重启说明以及升级的具体操作。

版本限制

待升级的实例版本需要满足以下要求。

当前版本	目标版本	操作文档
5.5.3	5.6.16	低版本升级和内核版本升级
5.6.16	6.3.2
6.3.2	6.7.0
8.x	最新版本	8.x版本升级到最新版

重要

如果您当前使用的版本不满足以上要求，则无法直接升级版本，建议您退订后重新按需购买。

升级重启方式

升级操作会触发集群重启，重启时长与集群中的数据大小、数据结构、集群规格等有关，一般为1个小时左右。阿里云ES支持两种重启方式，系统会根据您的升级方案选择合适的重启方式。

重启方式	原理	风险和建议	适用的版本
蓝绿变更重启	在集群中先增加高版本节点，再将低版本节点的数据迁移到高版本节点，最后删除低版本节点的方式进行重启。	升级操作无法取消，升级期间可以继续向集群写入数据或从集群读取数据，但不能进行其他变更操作，建议在流量低峰期进行。节点的IP地址会发生变化。如果在集群配置或客户端访问集群的代码中指定了IP地址，需要在升级后更新配置或代码。	5.5.3升级至5.6.16 6.3.2升级至6.7.0 8.x升级至最新版内核版本升级
全量重启	所有节点完全关闭后重启。	升级过程需要为集群安装TLS证书，会导致服务不可用。但不会造成数据丢失，升级持续时间主要与集群数据量和规格相关，建议提前规划好时间。说明全量重启后，集群节点的IP地址不会发生变化，因此您无需对实例进行配置变更。	5.6.16升级至6.3.2

注意事项

当前集群版本与目标升级版本之间可能存在破坏性变更（Breaking changes）、较小变更和不再推荐使用的功能（Deprecations）。详细信息，请参见Migration guide。
说明
8.9和8.15版本包含破坏性变更，其余8.x版本仅涉及较小变更。更多信息，请参见Migrating to 8.15和Migrating to 8.9。
如果您使用了任何ES插件，请确保每个插件版本与目标版本兼容，否则可能导致插件无法正常使用。
如果您同时在使用Logstash、APM、Beats、Fleet/Elastic Agent、Elastic Security、Enterprise Search等功能，请确保它们与目标版本兼容。
开始升级前，请确保集群已保留最新数据的快照。一旦出现升级失败的情况，您将需要从快照中恢复最新数据。
在升级生产集群前，建议您先使用测试环境或测试实例完成升级过程的验证。
建议您在升级过程中不要新建索引，尽量在业务低峰期升级生产集群。
版本升级过程涉及Kibana版本的变化，在升级过程中Kibana无法使用。

操作步骤

低版本升级和内核版本升级

登录阿里云Elasticsearch控制台。
在左侧导航栏，单击Elasticsearch实例。
进入目标实例。
1. 在顶部菜单栏处，选择资源组和地域。
2. 在Elasticsearch实例中单击目标实例ID。
在基本信息页面，单击右侧的更新与升级。
在版本升级对话框中，选择操作类型和目标版本。
支持两种操作类型：
- 更新内核补丁：不改变ES实例的版本，只升级内核版本。仅内核增强版实例支持升级内核版本，各内核版本特性的详细说明，请参见内核版本发布记录。
  说明
  当系统检测到内核有新特性发布时，会在实例基本信息页面的版本右侧显示有可更新的内核补丁提示，您也可以单击该提示升级内核版本。
- Elasticsearch版本升级：只升级ES实例的版本，不会同步升级内核补丁。
单击升级检查，系统会对配置兼容性、集群状态、集群快照备份以及基础资源进行检查。
检查完成后，请根据页面提示处理异常结果，并单击重新检查。更多信息，请参见升级检查。
检查项说明：
- 配置兼容检查
  检查升级前后两个版本是否有不兼容配置，主要适用于版本跨度较大的升级场景，例如5.x升级至6.x。如果检查不通过，流程将终止。终止后，可查看对应的检查项和解决方案进行处理，然后重新进行升级操作。详细信息请参见配置兼容检查和配置不兼容的调整方法。
- 集群状态检查
  检查升级前集群状态是否为正常（Green）状态，以及负载是否符合检查要求。在检查前或检查失败时，可参见集群状态检查，检查集群负载是否处于正常水位。
- 集群快照备份
  检查升级前的最近1个小时内是否完成过快照备份。如果升级操作失败，您可以通过备份的快照还原数据。
  说明
  - 如果最近1个小时内没有完成过快照备份，您可以在版本升级页面单击手动备份，手动触发快照操作。快照备份详情，请参见数据备份概述。
  - 快照备份所消耗的时间与集群数据量相关，如果集群未开启自动快照备份，且数据量较大，那么第一次快照时间会比较长。
检查通过后，单击开始升级。
升级期间，可在任务列表中查看升级进度。升级完成后，可在实例的基本信息页面，查看升级后的实例版本或内核版本。

8.x版本升级到最新版

登录阿里云Elasticsearch控制台。
在左侧导航栏，单击Elasticsearch实例。
进入目标实例。
1. 在顶部菜单栏处，选择资源组和地域。
2. 在Elasticsearch实例中单击目标实例ID。
在基本信息区域的右上角，单击更新与升级。
在更新与升级控制面板的版本选择向导页面，选择升级后的版本。
1. 操作类型选择Elasticsearch版本升级。
2. 升级版本仅支持选择阿里云ES的最新版本。
3. 阅读风险提示，确认没问题后，选中风险提示。
4. 单击下一步。
在升级检查向导页面，进行升级检查。
1. 如果最近一个小时内没有已完成的集群快照，单击手动备份按钮，备份集群快照。
2. 如果集群健康状态和基础资源校验没有通过，请参见升级检查进行人工检查。
3. 单击重新检测，直到所有的检测项都通过后，单击下一步。
在插件配置向导页面，根据页面提示和业务需求进行插件配置。
插件配置区域，显示检验通过，即完成了插件配置。
单击开始变更，在弹出的对话框中单击确认。
升级期间可能会因节点变化产生业务抖动，请务必在业务低峰期操作。版本升级变更包含两个阶段：
1. 灰度变更：灰度变更后及时确认集群稳定性，做好业务观测。如有异常情况，及时提交工单联系阿里云ES技术人员进行回滚操作。
2. 全量变更：灰度变更完成且确认业务稳定后，在控制台单击全量变更，发起全量变更。
  发起全量变更后将不再支持任何形式的回滚。

检索分析服务Elasticsearch版：升级版本