使用 docker 部署 elasticsearch 并安装 ik 中文分词器

jgrass

发布于 2024-12-25 17:54:26

26100

代码可运行

文章被收录于专栏：蔻丁杂记蔻丁杂记

运行总次数：0

代码可运行

这是一篇本地 docker 部署笔记，基本上是参考以下文章。记录一些实际操作中遇到的问题。

ElasticSearch中文分词，看这一篇就够了_静待花开-CSDN博客_elasticsearch 中文分词

最清晰易懂的Elasticsearch操作手册｜收藏夹必备_静待花开-CSDN博客_elasticsearch 操作手册

elasticsearch使用ik中文分词器 - SegmentFault 思否

1 镜像准备

docker search elasticsearch

搜索 elasticsearch 可以看到如下镜像，

这里使用第二个，集成了 es 和 kibana 。

nshou/elasticsearch-kibana - Docker Image | Docker Hub

拉取镜像

docker pull nshou/elasticsearch-kibana

创建并运行容器

Terminal window

docker run -d -p 9200:9200 -p 9300:9300 -p 5601:5601 --name eskibana  nshou/elasticsearch-kibana

进入容器（这里的 ddade0ae3 是上一句返回的容器 ID）

docker exec -it ddade0ae3 bash

2 将数据/配置目录挂载

如果不使用挂载，容器被删除之后，数据就没有了。实际使用中，通常将持久化数据挂载出来。

需要挂载的文件/目录：配置文件，数据目录，插件目录。

可以先将容器中默认的配置文件拷贝出来，免得自己新建一个。

这里 018d550c168c 是容器 ID，命令在宿主机执行，执行目录是自己选定的一个准备用来挂载的目录。

我这里的目录是：/Users/myname/Documents/docker/es/vol/eskibana

Terminal window

docker cp 018d550c168c:/home/elasticsearch/kibana-7.16.2-linux-x86_64/config/kibana.yml ./kibana-bak/docker cp 018d550c168c:/home/elasticsearch/elasticsearch-7.16.2/config/elasticsearch.yml ./es-bak/

将文件拷贝出来之后，准备挂载的目录。

最终目录是这个样子，bak 目录是做备份用的。

赋读写权限

Terminal window

chmod -R 777 ./eschmod -R 777 ./kibana

将之前运行起来的容器关闭（否则端口会占用），使用挂载运行新的容器

Terminal window

docker run --name esk \-p 9200:9200 -p 9300:9300 -p 5601:5601 \-e "discovery.type=single-node" \-e ES_JAVA_OPTS="-Xms64m -Xmx512m" \-v /Users/xxx/Documents/docker/es/vol/eskibana/es/config/elasticsearch.yml:/home/elasticsearch/elasticsearch-7.16.2/config/elasticsearch.yml \-v /Users/xxx/Documents/docker/es/vol/eskibana/es/data:/home/elasticsearch/elasticsearch-7.16.2/data \-v /Users/xxx/Documents/docker/es/vol/eskibana/es/plugins:/home/elasticsearch/elasticsearch-7.16.2/plugins \-v /Users/xxx/Documents/docker/es/vol/eskibana/kibana/config/kibana.yml:/home/elasticsearch/kibana-7.16.2-linux-x86_64/config/kibana.yml \-v /Users/xxx/Documents/docker/es/vol/eskibana/kibana/data:/home/elasticsearch/kibana-7.16.2-linux-x86_64/data \-v /Users/xxx/Documents/docker/es/vol/eskibana/kibana/plugins:/home/elasticsearch/kibana-7.16.2-linux-x86_64/plugins \-d nshou/elasticsearch-kibana

参考：

Docker部署Elasticsearch

docker安装ElasticSearch

如果运行时发现如下错误，

Error response from daemon: Mounts denied:The path /es/data is not shared from the host and is not known to Docker.You can configure shared paths from Docker -> Preferences... -> Resources -> File Sharing.See https://docs.docker.com/desktop/mac for more info.

1 根据提示检查 docker 配置，2 使用绝对路径

参考：关于 is not shared from OS X and is not known to Docker._程序和我有一个能跑就行了-CSDN博客

3 安装中文分词插件

我这里使用的是使用先手动下载，再使用命令安装的方式。

3.1 从 github 下载插件 zip 包

https://github.com/medcl/elasticsearch-analysis-ik/releases

3.2 将 zip 包拷贝到容器中

docker cp ./ik.zip f8ad1fb16b0:/home/elasticsearch/mytmp

3.3 在容器中安装插件

这句需要在 es 目录中的 bin 目录下运行，elasticsearch-plugin 并不是一个全局指令

./elasticsearch-plugin install file:///home/elasticsearch/mytmp/ik.zip

安装完成插件之后，需要重启容器

重启时，如果出现如下错误，

Exception in thread "main" java.nio.file.NotDirectoryException: /home/elasticsearch/elasticsearch-7.16.2/plugins/.DS_Store

则需要删除 plugins 目录中的 .DS_Store 文件

Terminal window

ls -arm .DS_Store

然后重启容器，测试中文分词

POST /_analyze{"analyzer": "ik_max_word","text": "且听风吟"}

结果：

{  "tokens" : [    {      "token" : "且听",      "start_offset" : 0,      "end_offset" : 2,      "type" : "CN_WORD",      "position" : 0    },    {      "token" : "风吟",      "start_offset" : 2,      "end_offset" : 4,      "type" : "CN_WORD",      "position" : 1    }  ]}

4 测试 ES 与 kibana

访问 http://127.0.0.1:5601 以访问 kibana，在 dev tools 中做测试。

使用 elasticsearch-head Chrome 插件查看数据。

5 测试挂载效果

将上面启动的容器关闭，使用上面的命令，启动一个新的容器

Terminal window

docker run --name esk2 \-p 9200:9200 -p 9300:9300 -p 5601:5601 \-e "discovery.type=single-node" \-e ES_JAVA_OPTS="-Xms64m -Xmx512m" \-v /Users/xxx/Documents/docker/es/vol/eskibana/es/config/elasticsearch.yml:/home/elasticsearch/elasticsearch-7.16.2/config/elasticsearch.yml \-v /Users/xxx/Documents/docker/es/vol/eskibana/es/data:/home/elasticsearch/elasticsearch-7.16.2/data \-v /Users/xxx/Documents/docker/es/vol/eskibana/es/plugins:/home/elasticsearch/elasticsearch-7.16.2/plugins \-v /Users/xxx/Documents/docker/es/vol/eskibana/kibana/config/kibana.yml:/home/elasticsearch/kibana-7.16.2-linux-x86_64/config/kibana.yml \-v /Users/xxx/Documents/docker/es/vol/eskibana/kibana/data:/home/elasticsearch/kibana-7.16.2-linux-x86_64/data \-v /Users/xxx/Documents/docker/es/vol/eskibana/kibana/plugins:/home/elasticsearch/kibana-7.16.2-linux-x86_64/plugins \-d nshou/elasticsearch-kibana

如果前一个容器没有删除，这里的 —name 需要取个新名字。

如果一切正常，等待重启完成之后，之前的数据，kibana 中配的看板等，应该都还存在。