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

2023-09-30 14:31:58

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

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

1 镜像准备

docker search elasticsearch

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

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

nshou/elasticsearch-kibana - Docker Image | Docker Hub

拉取镜像

docker pull nshou/elasticsearch-kibana

创建并运行容器

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

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 目录是做备份用的。

赋读写权限

chmod -R 777 ./es
chmod -R 777 ./kibana

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

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 文件

ls -a
rm .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 测试挂载效果

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

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 中配的看板等，应该都还存在。

码农公寓

1 镜像准备

2 将数据/配置目录挂载

3 安装中文分词插件

4 测试 ES 与 kibana

5 测试挂载效果

相关文章