### 歡迎訪問我的GitHub
> 這裡分類和彙總了欣宸的全部原創(含配套原始碼)：[https://github.com/zq2599/blog_demos](https://github.com/zq2599/blog_demos)

### 關於ik分詞器
- elasticsearch常用的中文分詞器是ik分詞器，安裝和使用的詳情請參考[《elasticsearch安裝和使用ik分詞器》](http://blog.itpub.net/70017844/viewspace-2908348/)；

### docker下的elasticsearch，如何安裝ik分詞器
- 藉助elasticsearch的官方映象，我們在docker環境能快速搭建elasticsearch服務，但是ik分詞器如何安裝呢？

- 第一種方法：執行**docker exec**>命令進入容器，再按照物理機的步驟來安裝，顯然每次建立容器都要這麼做一次的話代價太高了；
- 第二種方法：做個整合了ik分詞器的elasticsearch映象，這樣每個容器執行的時都自帶了ik分詞器；

- 今天實戰的內容就是上面的第二種方法：自制elasticsearch映象，該映象繼承了ik分詞器；

### 版本資訊
1. 作業系統：CentOS 7.6
2. docker：17.03.2-ce
3. docker-compose：version 1.23.2
4. elasticsearch：這裡選用的是6.5.0版本的elasticsearch，因為目前ik分詞器官方最高只支援到6.5.0版本

### 常規的安裝步驟
- 先來梳理一下常規的ik分詞器安裝步驟：
1. 準備maven環境；
2. 下載ik分詞器原始碼；
3. 編譯構建原始碼；
4. 編譯結果是個zip包，複製到elasticsearch的外掛目錄去解壓；
5. 啟動elasticsearch；

- 以上就是常規安裝步驟，接下來就是把這些在elasticsearch的映象中再做一遍即可；

### 編寫Dockerfile
- Dockerfile的內容如下，已經有了詳細註釋就不再贅述了：

```shell
#Docker image of elasticsearch with ik tokenizer
# VERSION 6.5.0
# Author: bolingcavalry

#基礎映象使用elasticsearch:6.5.0
FROM elasticsearch:6.5.0

#作者
MAINTAINER BolingCavalry <zq2599>

#es外掛目錄
ENV ES_PLUGINS_PATH /usr/share/elasticsearch/plugins

#定義maven的安裝目錄
ENV MAVEN_BASE_PATH /opt

#定義編譯ik分詞器原始碼的目錄
ENV IK_SRC_COMPILE_PATH /opt/ik_build

#maven解壓後的資料夾名稱
ENV MAVEN_PACKAGE_NAME apache-maven-3.6.0

#將maven的bin目錄加入PATH
ENV PATH="${MAVEN_BASE_PATH}/${MAVEN_PACKAGE_NAME}/bin:${PATH}"

#進入要安裝maven的資料夾
RUN cd $MAVEN_BASE_PATH && \
#下載maven壓縮包
wget https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.6.0/binaries/apache-maven-3.6.0-bin.tar.gz && \
#解壓maven
tar -zxvf ${MAVEN_PACKAGE_NAME}-bin.tar.gz && \
#建立編譯ik分詞器原始碼的目錄
mkdir $IK_SRC_COMPILE_PATH && \
#進入編譯ik分詞器原始碼的目錄
cd $IK_SRC_COMPILE_PATH && \
#下載ik原始碼包
wget https://codeload.github.com/medcl/elasticsearch-analysis-ik/zip/master && \
#解壓原始碼包
unzip master && \
#進入解壓後的目錄
cd elasticsearch-analysis-ik-master && \
#透過maven構建
mvn clean package -U -DskipTests && \
#建立ik資料夾
mkdir $ES_PLUGINS_PATH/ik && \
#構建成功後，將檔案移動到外掛目錄
mv target/releases/*.zip $ES_PLUGINS_PATH/ik && \
#cd到ik資料夾
cd $ES_PLUGINS_PATH/ik && \
#解壓
unzip *.zip && \
#進入要安裝maven的資料夾
cd $MAVEN_BASE_PATH && \
#刪除不需要的資料夾
rm -rf ${MAVEN_PACKAGE_NAME}-bin.tar.gz ${MAVEN_PACKAGE_NAME} && \
#刪除ik的原始碼目錄
rm -rf $IK_SRC_COMPILE_PATH
```

### 構建映象
- 在Dockerfile所在目錄執行以下命令即可構建映象：

```shell
docker build -t bolingcavalry/elasticsearch-with-ik:6.5.0 .
```
- 構建的過程中，mave編譯構建的時候會在下載很多jar包，比較耗時，請耐心等待；

- 構建成功後，執行命令**docker history bolingcavalry/elasticsearch-with-ik:6.5.0**>檢視構建資訊，如下：

```shell
[root@hedy es]# docker history bolingcavalry/elasticsearch-with-ik:6.5.0
IMAGE               CREATED             CREATED BY                                      SIZE                COMMENT
abef02e45496        About an hour ago   /bin/sh -c cd $MAVEN_BASE_PATH && wget htt...   50.2 MB             
92a91169e693        About an hour ago   /bin/sh -c #(nop)  ENV PATH=/opt/apache-ma...   0 B                 
9ddccd9a491a        About an hour ago   /bin/sh -c #(nop)  ENV MAVEN_PACKAGE_NAME=...   0 B                 
d4a3e11e500e        About an hour ago   /bin/sh -c #(nop)  ENV IK_SRC_COMPILE_PATH...   0 B                 
cde29a40070e        About an hour ago   /bin/sh -c #(nop)  ENV MAVEN_BASE_PATH=/opt     0 B                 
979b6bb94f88        About an hour ago   /bin/sh -c #(nop)  ENV ES_PLUGINS_PATH=/us...   0 B                 
61d45dcbea07        About an hour ago   /bin/sh -c #(nop)  MAINTAINER BolingCavalr...   0 B                 
ff171d17e77c        2 months ago        /bin/sh -c #(nop)  CMD ["eswrapper"]            0 B                 
<missing>           2 months ago        /bin/sh -c #(nop)  ENTRYPOINT ["/usr/local...   0 B                 
<missing>           2 months ago        /bin/sh -c #(nop)  LABEL org.label-schema....   0 B                 
<missing>           2 months ago        /bin/sh -c #(nop)  EXPOSE 9200 9300             0 B                 
<missing>           2 months ago        /bin/sh -c chgrp 0 /usr/local/bin/docker-e...   5.05 kB             
<missing>           2 months ago        /bin/sh -c #(nop) COPY --chown=1000:0file:...   4.36 kB             
<missing>           2 months ago        /bin/sh -c #(nop)  ENV PATH=/usr/share/ela...   0 B                 
<missing>           2 months ago        /bin/sh -c #(nop) COPY --chown=1000:0dir:5...   237 MB              
<missing>           2 months ago        /bin/sh -c #(nop) WORKDIR /usr/share/elast...   0 B                 
<missing>           2 months ago        /bin/sh -c groupadd -g 1000 elasticsearch ...   296 kB              
<missing>           2 months ago        /bin/sh -c yum update -y &&     yum instal...   25.7 MB             
<missing>           2 months ago        /bin/sh -c ln -sf /etc/pki/ca-trust/extrac...   0 B                 
<missing>           2 months ago        /bin/sh -c #(nop)  ENV JAVA_HOME=/opt/jdk-...   0 B                 
<missing>           2 months ago        /bin/sh -c curl -s https://download.java.n...   310 MB              
<missing>           2 months ago        /bin/sh -c #(nop)  ENV ELASTIC_CONTAINER=true   0 B                 
<missing>           3 months ago        /bin/sh -c #(nop)  CMD ["/bin/bash"]            0 B                 
<missing>           3 months ago        /bin/sh -c #(nop)  LABEL org.label-schema....   0 B                 
<missing>           3 months ago        /bin/sh -c #(nop) ADD file:fbe9badfd2790f0...   200 MB
```

### 驗證映象
- 接下來在Docker上部署elasticsearch叢集，驗證做好的映象是否好用，建立docker-compose.yml檔案，內容如下：

```shell
version: '2.2'
services:
  elasticsearch:
    image: bolingcavalry/elasticsearch-with-ik:6.5.0
    container_name: elasticsearch
    environment:
      - cluster.name=docker-cluster
      - bootstrap.memory_lock=true
      - http.cors.enabled=true
      - http.cors.allow-origin=*
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - esdata1:/usr/share/elasticsearch/data
    ports:
      - 9200:9200
    networks:
      - esnet
  elasticsearch2:
    image: bolingcavalry/elasticsearch-with-ik:6.5.0
    container_name: elasticsearch2
    environment:
      - cluster.name=docker-cluster
      - bootstrap.memory_lock=true
      - http.cors.enabled=true
      - http.cors.allow-origin=*
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
      - "discovery.zen.ping.unicast.hosts=elasticsearch"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - esdata2:/usr/share/elasticsearch/data
    networks:
      - esnet
volumes:
  esdata1:
    driver: local
  esdata2:
    driver: local

networks:
  esnet:
```

- 在docker-compose.yml檔案所在目錄下執行命令**docker-compose up -d**>，即可建立yml檔案中編排的容器，如下：

```shell
[root@hedy ik]# docker-compose up -d
Creating network "ik_esnet" with the default driver
Creating elasticsearch  ... done
Creating elasticsearch2 ... done
```

- 假設docker所在電腦的IP地址是**192.168.1.101**>，執行以下命令來建立一個索引：

```shell
curl -X PUT http://192.168.1.101:9200/test001
```

- 執行以下命令驗證ik分詞器效果：

```shell
curl -X POST \
'http://192.168.1.101:9200/test001/_analyze?pretty=true' \
-H 'Content-Type: application/json' \
-d '{"text":"我們是軟體工程師","tokenizer":"ik_smart"}'
```

- 收到的響應如下，可見ik分詞器已經生效：

```shell
{
  "tokens" : [
    {
      "token" : "我們",
      "start_offset" : 0,
      "end_offset" : 2,
      "type" : "CN_WORD",
      "position" : 0
    },
    {
      "token" : "是",
      "start_offset" : 2,
      "end_offset" : 3,
      "type" : "CN_CHAR",
      "position" : 1
    },
    {
      "token" : "軟體",
      "start_offset" : 3,
      "end_offset" : 5,
      "type" : "CN_WORD",
      "position" : 2
    },
    {
      "token" : "工程師",
      "start_offset" : 5,
      "end_offset" : 8,
      "type" : "CN_WORD",
      "position" : 3
    }
  ]
}
```

### 將映象提交到docker映象倉庫

- 前面構建好的映象只存在本地電腦，我們可以將其提交到docker倉庫給更多使用者使用：
- 提交映象到hub.docker.com網站，需要用到該網站的賬號，請確保您已經在此網站註冊過；
- 執行**docker login**>登入，期間會要求輸入使用者名稱和密碼；
- 執行命令**docker push bolingcavalry/elasticsearch-with-ik:6.5.0**>，即可將本地映象push到hub.docker.com；
- 注意映象名稱的字首，例如我這裡的字首是**bolingcavalry**>，要和賬號保持一致；
- 提交成功後，在hub.docker.com網站即可看到此映象，如下圖，此時任何人都可以pull來下使用了：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190127194107831.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5,size_16,color_FFFFFF,t_70)
- 至此，ik分詞器映象的製作和驗證就完成了，希望能幫助您在docker下更方便的使用elasticsearch服務；

### 歡迎關注ITpub：程式設計師欣宸
> [學習路上，你不孤單，欣宸原創一路相伴...](http://blog.itpub.net/70017844/)</missing></missing></missing></missing></missing></missing></missing></missing></missing></missing></missing></missing></missing></missing></missing></missing></missing></zq2599>

自己動手製作elasticsearch的ik分詞器的Docker映象

相關文章