想要尽快的熟悉一样东西的方法,就是去使用它,所以我们需要先把 Elasticsearch 运行起来,这样我们才能去使用它、学习它。

官方文档中介绍,最快的入门 Elasticsearch 的方法是在云中免费试用14天 Elasticsearch 服务 (opens new window)

我们不用这种方式,我们按官方文档,在本地运行 Elasticsearch。

安装 Elasticsearch (opens new window)

安装步骤如下:

  1. 下载 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)

  1. 解压文件:

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
  1. 从 解压后的bin 目录中启动 Elasticsearch:

Linux and macOS:

cd elasticsearch-7.11.1/bin
./elasticsearch

Windows:

cd elasticsearch-7.11.1\bin
.\elasticsearch.bat

现在运行了一个单节点 Elasticsearch 集群。

  1. 再启动两个 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。在本地运行的所有三节点,他们将自动与第一个节点加入集群。

  1. 使用 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 方法或操作。例如,GETPOSTPUTHEADDELETE

<PROTOCOL>

httphttps。如果你在 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),也请关注后续文章。