Elasticsearch 集群版本升级步骤及注意事项是什么

发布时间：2021-12-16 17:00:16 作者：柒染
来源：亿速云阅读：766

# Elasticsearch 集群版本升级步骤及注意事项

## 目录
1. [升级前的准备工作](#升级前的准备工作)
2. [升级路径规划](#升级路径规划)
3. [完整升级步骤](#完整升级步骤)
4. [升级后验证](#升级后验证)
5. [常见问题与解决方案](#常见问题与解决方案)
6. [回滚方案](#回滚方案)
7. [最佳实践建议](#最佳实践建议)

---

## 升级前的准备工作

### 1.1 版本兼容性检查
- **跨版本限制**：Elasticsearch不支持跨大版本升级（如6.x→8.x需先升到7.x）
- **检查升级路径**：使用官方[Upgrade Assistant](https://www.elastic.co/guide/en/elastic-stack/current/upgrading-elastic-stack.html)工具
- **客户端兼容性**：确认Java客户端、Kibana等配套组件的版本兼容性

### 1.2 集群健康检查
```bash
GET _cluster/health?pretty
GET _cat/nodes?v

确保所有节点状态为green
检查未分配的分片数量应为0

1.3 数据备份

必须执行的备份方案：

# 创建快照仓库
PUT _snapshot/my_backup
{
  "type": "fs",
  "settings": {
    "location": "/mnt/backups/elasticsearch"
  }
}

# 执行快照
PUT _snapshot/my_backup/snapshot_1?wait_for_completion=true

1.4 系统资源评估

资源类型	建议值
磁盘空间	当前使用量的2倍
JVM Heap	不超过物理内存的50%
文件描述符限制	至少65535

升级路径规划

2.1 标准升级路径

graph LR
    A[6.8] --> B[7.17]
    B --> C[8.12]

2.2 特殊场景处理

插件兼容性：重新编译自定义插件
弃用功能迁移：
- 6.x中的_type字段需在7.x前移除
- 8.x默认启用安全功能

完整升级步骤

3.1 滚动升级流程（推荐）

# 1. 暂停分片分配
PUT _cluster/settings
{
  "persistent": {
    "cluster.routing.allocation.enable": "primaries"
  }
}

# 2. 停止索引写入（可选）
POST _flush/synced

# 3. 升级单个节点
sudo systemctl stop elasticsearch
sudo rpm -Uvh elasticsearch-8.12.1.rpm
sudo systemctl start elasticsearch

# 4. 检查节点加入情况
GET _cat/nodes?v

# 5. 重新启用分片分配
PUT _cluster/settings
{
  "persistent": {
    "cluster.routing.allocation.enable": null
  }
}

3.2 全集群重启升级

适用场景： - 跨大版本升级 - 硬件迁移场景

关键步骤： 1. 完全停止集群所有节点 2. 批量升级软件包 3. 按Master节点→Data节点→Coordinating节点顺序启动

升级后验证

4.1 基础功能检查

# 集群状态
GET _cluster/health

# 索引数据校验
GET _cat/indices?v

# 搜索功能测试
POST my_index/_search
{
  "query": {
    "match_all": {}
  }
}

4.2 性能基准测试

使用 Rally 工具：

esrally compare --baseline=7.17.0 --contender=8.12.1

4.3 安全配置检查

检查RBAC权限继承
验证TLS证书有效性
审计日志功能测试

常见问题与解决方案

5.1 典型问题列表

问题现象	可能原因	解决方案
节点无法加入集群	网络隔离或配置错误	检查`discovery.seed_hosts`
分片长期处于UNASSIGNED状态	版本不兼容	手动分配分片或重建索引
查询返回空结果	映射类型变化	使用reindex API重建数据

5.2 日志分析技巧

# 关键错误日志过滤
grep -E "ERROR|WARN|Exception" /var/log/elasticsearch/*.log

# 慢查询日志分析
PUT _settings
{
  "index.search.slowlog.threshold.query.warn": "10s"
}

回滚方案

6.1 快照恢复流程

# 关闭索引写入
POST _all/_close

# 从快照恢复
POST _snapshot/my_backup/snapshot_1/_restore?wait_for_completion=true

# 重新打开索引
POST _all/_open

6.2 版本降级注意事项

需要完全删除新版本数据目录
不支持自动配置降级，需手动恢复配置文件

最佳实践建议

7.1 升级窗口选择

避免业务高峰期
建议在维护窗口期进行
预留至少50%的时间buffer

7.2 监控策略调整

更新Grafana仪表盘中的指标阈值
调整告警规则（如JVM内存占用率）

7.3 文档更新清单

更新集群拓扑图
记录最终配置文件差异
更新应急预案文档

重要提示：生产环境升级前，务必在测试环境完成全流程验证！建议通过Elastic官方论坛获取最新升级建议。 “`

注：本文档基于Elasticsearch 8.x版本编写，实际升级时请以官方文档为准。