从 Elasticsearch 迁移到 OpenSearch

适用场景

需要从 Elasticsearch 切换到 OpenSearch，或希望使用许可证更宽松的搜索栈。两者 API 高度相似，但插件、安全配置和版本兼容性需要逐项验证。

前置条件

• 确认源 Elasticsearch 版本与目标 OpenSearch 版本兼容。
• 准备快照仓库（S3/MinIO/共享文件系统）。
• 梳理索引、模板、别名、ILM/ISM 和插件。
• 保留旧集群作为回滚路径。

步骤

1. 记录源集群信息：

curl -s http://es:9200 | jq
curl -s 'http://es:9200/_cat/indices?v'
curl -s 'http://es:9200/_cat/aliases?v'

2. 注册快照仓库并创建快照：

curl -X PUT 'http://es:9200/_snapshot/backup' \
  -H 'Content-Type: application/json' \
  -d '{"type":"s3","settings":{"bucket":"es-backup","base_path":"migration"}}'

curl -X PUT 'http://es:9200/_snapshot/backup/snap-1?wait_for_completion=true'

3. 在 OpenSearch 注册同一仓库并恢复：

curl -X PUT 'http://os:9200/_snapshot/backup' \
  -H 'Content-Type: application/json' \
  -d '{"type":"s3","settings":{"bucket":"es-backup","base_path":"migration"}}'

curl -X POST 'http://os:9200/_snapshot/backup/snap-1/_restore?wait_for_completion=true'

4. 迁移索引模板和组件模板：

curl -s 'http://es:9200/_index_template' > templates.json
# 检查字段和版本后写入 OpenSearch

5. 迁移 ILM 到 ISM，调整策略名称和 API。

6. 切换客户端：更新连接地址、认证方式和兼容头。

验证

• 索引数量、文档数、别名和 mapping 一致。
• 查询、聚合、排序和分页结果一致。
• 写入和刷新正常。
• 快照和恢复流程可用。
• 监控和告警已切换。

回滚

• 保留 Elasticsearch 集群和原连接串。
• 切换前停止写入或开启双写。
• 回滚时确认 OpenSearch 中的新数据已补偿。
• DNS 切换使用短 TTL。

常见坑

• 版本跨度过大，快照格式不兼容。
• 插件（IK 分词、SQL、告警）在 OpenSearch 没有对应版本。
• 安全配置差异：证书、用户、角色和 API Key。
• ILM 与 ISM 语义不同，索引没有按预期滚动。
• 客户端使用 Elasticsearch 专有 API，OpenSearch 不支持。
• 索引模板优先级和组合模板行为不同。
• 文档数一致但 mapping 动态字段不同，聚合结果偏差。
• 双写期间冲突处理不完整。

相关命令

• curl — 快照、恢复和索引管理
• elasticsearch / opensearch — 集群服务
• jq — 处理 JSON 响应
• logstash / filebeat — 数据采集