elasticsearch版本升级注意什么

Elasticsearch（ES）版本升级是比较常见但风险较高的操作，稍不注意就可能导致数据丢失、集群不可用或客户端不兼容。下面从升级前、升级中、升级后三个维度，系统说明注意事项。

一、升级前必须确认的事项

1. 明确升级路径（非常重要）

ES 不支持跨大版本直接升级，必须逐级升级：

• 5.x → 6.x → 7.x → 8.x
• 同一大版本内可直接小版本升级（如 7.10 → 7.17）

✅ 官方升级路径检查工具：

https://www.elastic.co/support/matrix/upgrading

2. 检查当前版本与兼容性问题

（1）查看版本

GET /

（2）重点检查项

• 索引 mapping 是否使用了已废弃字段类型
• 是否使用了 type（ES 7 已移除）
• 是否使用了 _template（ES 8 改用 index_template）
• 分词器、插件是否兼容新版本

3. 插件兼容性

升级 ES 后：

• 所有插件必须同步升级
• 自定义插件可能完全不兼容

常见插件：

• ik 分词器
• analysis-pinyin
• repository-s3 / hdfs

4. 客户端兼容性

⚠️ Kibana / Logstash / Beats 必须与 ES 主版本一致

5. 数据备份（红线）

升级前必须做：

PUT _snapshot/my_backup/snapshot_1

或：

• 集群整体快照
• 重要索引单独快照
• 配置文件备份（elasticsearch.yml、jvm.options）

6. 磁盘与资源检查

• 磁盘使用率 < 70%
• 预留足够临时空间（segment merge）
• JVM 堆内存建议 ≤ 50% 物理内存

二、升级方式选择

方式一：滚动升级（推荐）

✅ 适用：

• 集群模式
• 同一大版本内升级

特点：

• 不中断服务
• 一个节点一个节点升

方式二：全量重启升级

✅ 适用：

• 跨大版本
• 单节点

步骤：

1. 停集群
2. 升级所有节点
3. 启动

方式三：重建索引升级

✅ 适用：

• 老版本（如 5.x → 8.x）
• 数据结构变化大

流程：

旧集群 → reindex → 新集群

三、升级中注意事项

1. 关闭分片自动分配（滚动升级）

PUT _cluster/settings
{
  "transient": {
    "cluster.routing.allocation.enable": "none"
  }
}

升级完成后再开启。

2. 观察集群状态

GET _cat/health?v
GET _cat/nodes?v

确保：

• status = green / yellow
• 无 unassigned shards

3. 不要中途回滚

ES 不支持降级

升级失败只能靠快照恢复

四、升级后必须做的事

1. 重建系统索引（跨大版本）

POST _tasks?actions=*reindex

或：

POST .kibana/_upgrade

2. 检查废弃 API

GET _xpack/usage

或开启：

logger.org.elasticsearch.deprecation: debug

3. 验证业务

• 写入是否正常
• 查询是否变慢
• 分词结果是否一致

五、常见坑总结

❌ 直接 6 → 8
❌ Kibana 和 ES 版本不一致
❌ 忽略 _type 废弃
❌ 升级前不做快照
❌ 插件版本不匹配

六、推荐升级流程（标准）

1. 看官方升级矩阵
2. 全量快照
3. 小流量验证
4. 滚动升级
5. 监控 24h
6. 清理旧索引

如果你愿意，可以告诉我：

• 当前 ES 版本
• 目标版本
• 单节点还是集群

我可以给你一份针对性的升级方案。