Elastic：用 Docker 部署 Elastic 栈

Elasticsearch
218 阅读5分钟

在之前的文章 “如何在Linux，Mac OS及 Windows 上进行安装 Elasticsearch”，我介绍了如何通过安装包或者下载的压缩文件来进行安装 Elasticsearch。在今天的文章里，我们来详细介绍如何使用 docker 来进行安装 Elastic 栈。

 

安装

因为我们需要使用 docker 来进行安装，我们必须安装：

  1. docker：根据不同的操作系统，请按照要求安装docker。可以到网站 docs.docker.com/ 去安装
  2. docker-compose。这个可以到网站 docs.docker.com/compose/ins… 去安装

用 docker 来安装 Elasticsearch

有关所有已发布的 Docker 镜像和标记的列表，请访问 www.docker.elastic.co。 源文件在 Github 中。

下载 docker image

获取 Docker 的 Elasticsearch 就像对 Elastic Docker 注册表发出 docker pull 命令一样简单。

docker pull docker.elastic.co/elasticsearch/elasticsearch:7.3.2

上面是以 Elasticsearch 7.3.2 为例来示范的。在实际的使用中，可以替换它用自己喜欢的版本。

开发或测试环境

从命令行运行 Elasticsearch。使用以下命令可以快速启动 Elasticsearch 以进行开发或测试：

docker run -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" docker.elastic.co/elasticsearch/elasticsearch:7.3.2

请注意 single-node discovery，该发现允许绕过单节点开发集群中的 bootstrap checks 检查。

生产环境

m.max_map_count 内核设置需要设置为至少 262144 才能用于生产环境。 根据你的平台：

  • Linux

vm.max_map_count设置应该在 /etc/sysctl.conf 中永久设置：

$ grep vm.max_map_count /etc/sysctl.conf
vm.max_map_count=262144

要在实时系统上应用该设置，请执行以下操作：

sysctl -w vm.max_map_count = 262144

必须在xhyve虚拟机中设置vm.max_map_count设置：

$ screen ~/Library/Containers/com.docker.docker/Data/vms/0/tty

只需按 Enter 键并配置 sysctl 设置，就像对待 Linux 一样：

sysctl -w vm.max_map_count=262144

必须通过 docker-machine 设置 vm.max_map_count 设置：

docker-machine ssh
sudo sysctl -w vm.max_map_count=262144

用 docker 来安装 Kibana

有关所有已发布的 Docker 镜像和标记的列表，请访问 www.docker.elastic.co。 源代码在 GitHub 中。

下载 docker image

docker pull docker.elastic.co/kibana/kibana:7.3.2

开发或测试环境

可以使用以下命令快速启动 Kibana 并将其连接到本地 Elasticsearch 容器以进行开发或测试：

docker run --link YOUR_ELASTICSEARCH_CONTAINER_NAME_OR_ID:elasticsearch -p 5601:5601 {docker-repo}:{version}

针对我们的情况，我们首先按照上面的步骤把 Elasticsearch 的 docker 运行起来，然后执行如下的命令：

docker ps

显示的结果如下：

CONTAINER ID        IMAGE                                                 COMMAND                  CREATED             STATUS              PORTS                                            NAMES
3839f34c1d2d        docker.elastic.co/elasticsearch/elasticsearch:7.3.2   "/usr/local/bin/dock…"   7 minutes ago       Up 7 minutes        0.0.0.0:9200->9200/tcp, 0.0.0.0:9300->9300/tcp   admiring_matsumoto

上面的 docker 信息是已经安装好的的 Elasticsearch 的 docker 信息。我们然后执行如下的命令：

docker run --link 3839f34c1d2d:elasticsearch -p 5601:5601 docker.elastic.co/kibana/kibana:7.3.2

这样我们的 Kibana docker 就爬起来了。

 

使用 docker-compose 来启动 Elasticsearch 和 Kibana

在这一步，我们假定我们已经下载好 Elasticsearch 和 Kibana 的 docker image。如果你还没有这么做，可以执行如下的命令下载：

docker pull docker.elastic.co/elasticsearch/elasticsearch:7.3.2
docker pull docker.elastic.co/kibana/kibana:7.3.2

紧接着下来，我们来创建一个叫做 docker 的目录，并在这个目录里创建一个叫做 docker-compose.yml 的文件。它的内容如下：

$ pwd
/Users/liuxg/elastic/docker
localhost:docker liuxg$ ls
docker-compose.yml

docker-compose.yml:

version: '2.2'
services:
  es01:
    image: docker.elastic.co/elasticsearch/elasticsearch:7.3.2
    container_name: es01
    environment:
      - node.name=es01
      - discovery.seed_hosts=es02
      - cluster.initial_master_nodes=es01,es02
      - cluster.name=docker-cluster
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - esdata01:/usr/share/elasticsearch/data
    ports:
      - 9200:9200
    networks:
      - esnet
  es02:
    image: docker.elastic.co/elasticsearch/elasticsearch:7.3.2
    container_name: es02
    environment:
      - node.name=es02
      - discovery.seed_hosts=es01
      - cluster.initial_master_nodes=es01,es02
      - cluster.name=docker-cluster
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - esdata02:/usr/share/elasticsearch/data
    networks:
      - esnet

  kibana:
    image: docker.elastic.co/kibana/kibana:7.3.2
    container_name: kibana
    ports: ['5601:5601']    
    networks: ['esnet']
    environment:
      - SERVER_NAME=kibana.localhost
      - ELASTICSEARCH_HOSTS=http://es01:9200
      - I18N_LOCALE=zh-CN
      - ELASTICSEARCH_USERNAME=elastic
      - ELASTICSEARCH_PASSWORD=mypasword
    depends_on: ['es01']

volumes:
  esdata01:
    driver: local
  esdata02:
    driver: local

networks:
  esnet:

在这个配置中，我们创建了两个 Elasticsearch 的 node：es01 及 es02。节点 es01 侦听 localhost：9200，而 es02 通过 Docker 网络与 es01 对话。同时我们也创建了另外一个kibana 的 docker。我们可以在 environment 中配置它所需要的参数。具体的参数可以参照 Configuring Kibana。

等我们创建好这个 docker-compose.yml 文件后，我们在当前的目录下，打入如下的命令：

docker-compose up

或者：

docker-compose up -d

这里的 -d 选项表示在 detached 模式下，运行容器在后台。

运行的结果：

 

我们最终可以在浏览器中看见我们的 Kibana 被启动的样子：

 

如同我们之前的设置一样， 它运行起来的 Locale 设置的是中文。我们也可以同时看到两个被启动的 Elasticsearch 的节点：

一旦 docker 启动后，我们可以通过 docker 的命令来执行一些命令，比如

docker exec es01 ls /usr/share/elasticsearch

我们可以通过如下的命令进入到 docker 进行安装等：

docker exec -it es01 /bin/bash

$ docker exec -it es01 /bin/bash
[root@ec4d19f59a7d elasticsearch]# ls
LICENSE.txt  README.textile  config  jdk  logs     plugins
NOTICE.txt   bin             data    lib  modules
[root@ec4d19f59a7d elasticsearch]#

这里的 es01 是我们的 Elasticsearch 实例的名称。

我们也可以通过如下的方式来配置 Kibana。我们可以在 docker-compose.yml 的目录下创建另外一个叫做 kibana.yml 的文件：

kibana.yml

#
# ** THIS IS AN AUTO-GENERATED FILE **
#

# Default Kibana configuration for docker target
server.name: kibana
server.host: "0"
elasticsearch.hosts: [ "http://elasticsearch:9200" ]
i18n.locale: "zh-CN"
xpack.monitoring.ui.container.elasticsearch.enabled: true

这里我们做了一些简单的设置，比如我们配置了 locale 为中文。我们可以修改我们的 docker-compose.yml 文件如下：

docker-compose.yml

version: '2.2'
services:
  es01:
    image: docker.elastic.co/elasticsearch/elasticsearch:7.3.2
    container_name: es01
    environment:
      - node.name=es01
      - discovery.seed_hosts=es02
      - cluster.initial_master_nodes=es01,es02
      - cluster.name=docker-cluster
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - esdata01:/usr/share/elasticsearch/data
    ports:
      - 9200:9200
    networks:
      - esnet
  es02:
    image: docker.elastic.co/elasticsearch/elasticsearch:7.3.2
    container_name: es02
    environment:
      - node.name=es02
      - discovery.seed_hosts=es01
      - cluster.initial_master_nodes=es01,es02
      - cluster.name=docker-cluster
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - esdata02:/usr/share/elasticsearch/data
    networks:
      - esnet
  kibana:
    image: docker.elastic.co/kibana/kibana:7.3.2
    container_name: kibana
    networks: ['esnet']
    ports: ['5601:5601']
    environment:
      - ELASTICSEARCH_HOSTS=http://es01:9200
    volumes:
      - ./kibana.yml:/usr/share/kibana/config/kibana.yml            

volumes:
  esdata01:
    driver: local
  esdata02:
    driver: local

networks:
  esnet:

在这里，我们通过在 kibana 中的 volumes 来把本地的 kibana.yml 文件 bind mount 到我们的 docker 之中的 image 里。这样它代替 docker 里的 /usr/share/kibana/config/kibana.yml 文件从而使用我们在本地设置的 kibana.yml 文件。

当docker把所有的容器都跑起来后，我们可以通过如下的命令来查看:

$ docker-compose ps
 Name               Command               State               Ports             
--------------------------------------------------------------------------------
es01     /usr/local/bin/docker-entr ...   Up      0.0.0.0:9200->9200/tcp,       
                                                  9300/tcp                      
es02     /usr/local/bin/docker-entr ...   Up      9200/tcp, 9300/tcp            
kibana   /usr/local/bin/dumb-init - ...   Up      0.0.0.0:5601->5601/tcp

它显示了所有的端口的使用情况。

 

我们可以通过如下的办法把docker实例都停下来：

docker-compose down

这样我们很快地部署我们的 Elasticsearch 集群。

定制版本

从上面的 docker-compose.yml 中，我们可以看出来：所有的 Elastic Stack 的各个组件的版本都是一样的。如果我们想修改我们的版本的话，我们需要去修改每一个字符串。这样比较麻烦。为了方便 docker-compose 允许我们创建一个隐形的文件叫做 .env。 它的内容如下：

$ pwd
/Users/liuxg/elastic5/docker
liuxg:docker liuxg$ ls -al
total 16
drwxr-xr-x   4 liuxg  staff   128 Mar 16 17:06 .
drwxr-xr-x  18 liuxg  staff   576 Feb  6 14:08 ..
-rw-r--r--   1 liuxg  staff    28 Mar 16 17:06 .env
-rw-r--r--@  1 liuxg  staff  1473 Dec 17 11:02 docker-compose.yml
liuxg:docker liuxg$ cat .env 
ELASTIC_STACK_VERSION=7.6.1

在这个文件中，我们可以定义 ELASTIC_STACK_VERSION=7.6.1。一旦这样定义后，我们可以把我们的 docker-compose.yml 修个为：

docker-compose.yml

version: '2.2'
services:
  es01:
    image: docker.elastic.co/elasticsearch/elasticsearch:${ELASTIC_STACK_VERSION}
    container_name: es01
    environment:
      - node.name=es01
      - discovery.seed_hosts=es02
      - cluster.initial_master_nodes=es01,es02
      - cluster.name=docker-cluster
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - esdata01:/usr/share/elasticsearch/data
    ports:
      - 9200:9200
    networks:
      - esnet
  es02:
    image: docker.elastic.co/elasticsearch/elasticsearch:${ELASTIC_STACK_VERSION}
    container_name: es02
    environment:
      - node.name=es02
      - discovery.seed_hosts=es01
      - cluster.initial_master_nodes=es01,es02
      - cluster.name=docker-cluster
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - esdata02:/usr/share/elasticsearch/data
    networks:
      - esnet

  kibana:
    image: docker.elastic.co/kibana/kibana:${ELASTIC_STACK_VERSION}
    container_name: kibana
    ports: ['5601:5601']    
    networks: ['esnet']
    environment:
      - SERVER_NAME=kibana.localhost
      - ELASTICSEARCH_HOSTS=http://es01:9200
      - I18N_LOCALE=zh-CN
      - ELASTICSEARCH_USERNAME=elastic
      - ELASTICSEARCH_PASSWORD=mypassword
    depends_on: ['es01']

volumes:
  esdata01:
    driver: local
  esdata02:
    driver: local

networks:
  esnet:

这样以后如果我们想换一个版本的话，我们只需要修改 .env 文件的版本定义即可。

更进一步

如果你想了解如何为我们的由 docker 创建的 Elasticsearch 集群配置安全访问，请阅读我的另外一篇文章 “Elastic：为 Elastic Docker 部署设置安全”。

 

Elastic Stack docker 部署

 

参考：

【1】www.elastic.co/guide/en/ki…

【2】www.elastic.co/guide/en/el…

【3】github.com/BigDataBout…

avatar
文章
阅读
粉丝