Elasticsearch 9.X 官方文档大变样了!
最近升级 Elasticsearch 9.X,发现官方文档彻底改版了,变化不小!
今天花 3 分钟,给大家捋一捋核心变化。
一、Elasticsearch 官方文档网址变了!别找错地方
8.X 时代:
文档在 elastic.co/guide
👉 示例:https://www.elastic.co/guide/en/elasticsearch/reference/8.19/
从 5.X、6.X、7.X、8.X 一路跟过来的读者们应该对下面的界面非常熟悉。参加过 Elastic 认证的同仁更是相当熟悉。
9.X 时代:
全部搬到 elastic.co/docs
👉 新地址:https://www.elastic.co/docs/ 9.X
如下图所示,大家发现变化不少。
划重点:
老版本(8.19 及以前)还在 guide 路径 新版本(9.0 起)必须去 docs 站点 我们个人的 Elastic 收藏夹该更新了!
二、不再按版本分文档了
以前咋样? 8.0 一套文档、8.1 一套文档、8.2 又一套...每个版本独立维护。
现在咋样? 一个 9.x 文档打天下!所有 9.0、9.1、9.2 的变化都在一份文档里。
https://www.elastic.co/docs/get-started/howto-use-the-docs
怎么区分版本差异? 文档里加了"可用性徽章(标签)",哪个功能是 9.1 加的、哪个是 9.2 改的,一目了然。
好处:不用在多个版本文档间来回跳,看一份就够了!
三、文档组织逻辑变了
以前:按产品分
Elasticsearch Guide(查这个)
Kibana Guide(查那个)
Logstash Guide(再查另一个)
👉 8.X 示例:https://www.elastic.co/guide/en/elasticsearch/reference/8.19/index.html
现在:按你要干啥分
搭建搜索应用?→ Build powerful search and RAG applications
做可观测性?→ Resolve problems with observability
搞安全分析?→ Detect, investigate, and respond to threats
管理数据?→ Manage your data throughout its lifecycle
👉 9.X 新结构:https://www.elastic.co/docs/
说人话:不管你用什么产品,直接找你的业务场景就行。
四、Release Notes 独立了
8.X:
Release Notes 藏在 Installation and Upgrade Guide 里
👉 老位置:
https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/8.19/new.html
9.X:
独立放在 elastic.co/docs/release-notes
👉 新位置:
https://www.elastic.co/docs/release-notes/
现在 Elasticsearch、Kibana、Security、Observability 的发布说明都在一个地方,找起来方便多了。
五、API 文档路径加版本号了
8.X:
elastic.co/docs/api/doc/elasticsearch/operation/xxx
👉 示例:https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-get
9.X:
elastic.co/docs/api/doc/elasticsearch/v9/operation/xxx
👉 示例:https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-get
多了个 /v9/,以后不同大版本 API 能共存,不会混淆。
六、新增了啥?
1.客户端库导航 Java、Python、.Net 等客户端,ES|QL、KQL 等查询语言,都有单独入口
2.版本说明文档 专门写了篇"Versioning and availability",解释版本控制和功能可用性
https://www.elastic.co/docs/get-started/versioning-availability
这个链接很重要,建议务必收藏。
七、铭毅的建议
立刻更新书签
习惯新的找文档方式
关注内联版本标记
老项目还用 8.X?
八、总结一句话
Elastic 把文档从"产品手册"改成了"解决方案指南",更贴近实战场景,熟练使用后会发现找东西更快了!
9.X 不仅代码升级,文档体验也全面升级。适应新文档结构,能让你的开发效率翻倍!