想要尽快的熟悉一样东西的方法,就是去使用它,所以我们需要先把 Elasticsearch 运行起来,这样我们才能去使用它、学习它。
官方文档中介绍,最快的入门 Elasticsearch 的方法是在云中免费试用14天 Elasticsearch 服务 (opens new window)。
我们不用这种方式,我们按官方文档,在本地运行 Elasticsearch。
安装步骤如下:
- 下载 Elasticsearch 压缩包:
Linux: elasticsearch-7.11.1-linux-x86_64.tar.gz (opens new window)
curl -L -O https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.11.1-linux-x86_64.tar.gz
macOS: elasticsearch-7.11.1-darwin-x86_64.tar.gz (opens new window)
curl -L -O https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.11.1-darwin-x86_64.tar.gz
Windows: elasticsearch-7.11.1-windows-x86_64.zip (opens new window)
- 解压文件:
Linux:
tar -xvf elasticsearch-7.11.1-linux-x86_64.tar.gz
macOS:
tar -xvf elasticsearch-7.11.1-darwin-x86_64.tar.gz
Windows PowerShell:
Expand-Archive elasticsearch-7.11.1-windows-x86_64.zip
- 从 解压后的
bin
目录中启动 Elasticsearch:
Linux and macOS:
cd elasticsearch-7.11.1/bin
./elasticsearch
Windows:
cd elasticsearch-7.11.1\bin
.\elasticsearch.bat
现在运行了一个单节点 Elasticsearch 集群。
- 再启动两个 Elasticsearch 实例。需要为每个节点指定唯一的数据和日志路径。
Linux and macOS:
./elasticsearch -Epath.data=data2 -Epath.logs=log2
./elasticsearch -Epath.data=data3 -Epath.logs=log3
Windows:
.\elasticsearch.bat -E path.data=data2 -E path.logs=log2
.\elasticsearch.bat -E path.data=data3 -E path.logs=log3
额外的节点将被分配唯一的 ID。在本地运行的所有三节点,他们将自动与第一个节点加入集群。
- 使用
cat health API
验证你的三节点集群是否正运行。这个cat API
以比原生 JSON 更易读的格式返回关于集群和索引的信息。
可以通过 Elasticsearch REST API 提交 HTTP 请求,直接与集群交互。如果你安装和运行了 Kibana,你也可以打开 Kibana,并通过开发控制台(Dev Console
)提交请求。
当您准备在自己的应用程序中开始使用 Elasticsearch 时,您可能想查看Elasticsearch 语言客户端 (opens new window)。
GET /_cat/health?v=true
响应应该指示 Elasticsearch 集群的状态是绿色,且它有三个节点:
epoch timestamp cluster status node.total node.data shards pri relo init unassign pending_tasks max_task_wait_time active_shards_percent
1565052807 00:53:27 elasticsearch green 3 3 6 3 0 0 0 0 - 100.0%
如果只有一个 Elasticsearch 单实例,集群状态会保持为黄色。一个单节点集群是功能完整的,但数据不能被复制到另一个节点以提供弹性。集群状态为绿色时,副本分片必定可用。如果集群状态为红色,某些数据不可用。
可以通过 REST API 进行操作,自然也可以通过 curl命令操作 Elaticsearch。
标准的 curl 命令格式如下:
curl -X<VERB> '<PROTOCOL>://<HOST>:<PORT>/<PATH>?<QUERY_STRING>' -d '<BODY>'
这个示例使用以下变量:
<VERB>
合适的 HTTP 方法或操作。例如,
GET
、POST
、PUT
、HEAD
或DELETE
。
<PROTOCOL>
http
或https
。如果你在 Elasticsearch 之前有 HTTPS 代理,或者你使用的 Elasticsearch 安全特性去加密 HTTP 通信,使用后者。
<HOST>
Elasticsearch 集群的任意节点主机名。或者对本地机器上的节点使用
localhost
。
<PORT>
运行 Elasticsearch HTTP服务的端口,默认为
9200
。
<PATH>
API路径,可以包含多部分,比如
_cluster/stats
或_nodes/stats/jvm
。
<QUERY_STRING>
一些可选的查询字符串参数。比如,
?pretty
将打印 JSON 响应以使其更易阅读。
<BODY>
JSON 编码的请求体(如果必须)。
如果启用了 Elasticsearch 安全特性,你必须提供用于认证运行 API 的有效用户名(以及密码)。例如,使用 -u
或 --u
的 cURL 命令参数。有关运行每个 API 需要的安全权限的详情,参看 REST API (opens new window)。
Elasticsearch 对每个 API 请求响应 HTTP 状态码,如 200 ok
。除了 HEAD
请求外,它还会返回一个 JSON 编码的响应体。
按照以上官方介绍,我们就可以将 Elasticsearch 运行起来,并且使用简单的API查看 Elasticsearch 的状态以及标准的 RESTful API格式。
我们实际运行时,可能会看到以下提示说JDK 8 不适用于 Elasticsearch高版本:
Warning: with JDK 8 on Windows, Elasticsearch may be unable to derive correct
ergonomic settings due to a JDK issue (JDK-8074459). Please use a newer
version of Java.
Warning: MaxDirectMemorySize may have been miscalculated due to JDK-8074459.
Please use a newer version of Java or set MaxDirectMemorySize explicitly.
遇到这个提示时,可以忽略,也可以按提示配置MaxDirectMemorySize
参数或按提示安装 Java 11。
Elasticsearch 运行成功后,我们可以看到它的端口为 9200
,直接通过 Postman 访问 http://localhost:9200
,我们可以看到返回 200 ok
,以及以下响应体:
{
"name": "XXXXX",
"cluster_name": "elasticsearch",
"cluster_uuid": "6rV0qTnBQIyyTo85ZAOK-w",
"version": {
"number": "7.11.1",
"build_flavor": "default",
"build_type": "zip",
"build_hash": "ff17057114c2199c9c1bbecc727003a907c0db7a",
"build_date": "2021-02-15T13:44:09.394032Z",
"build_snapshot": false,
"lucene_version": "8.7.0",
"minimum_wire_compatibility_version": "6.8.0",
"minimum_index_compatibility_version": "6.0.0-beta1"
},
"tagline": "You Know, for Search"
}
如果看到以上响应体,也说明 Elasticsearch 运行成功。
以上,就是对 Elasticsearch 安装介绍,更多的安装介绍,可以查看我翻译的Elasticsearch 中文文档 (opens new window),也请关注后续文章。