vanson / elasticsearch-kibana-docker

Elasticsearch + Kibana + Docker Compose

Elasticsearch + KibanaをDocker Composeで動かす

概要

• Docker Composeを利用して、Elasticsearchを3ノード1クラスタ構成で起動させた
• Kibanaも立ち上げて、Elasticsearchと連携させた
• Docker Composeの設定値について、自分の理解した内容をまとめた

更新履歴

• 2022/03/13
  • Elasctic Stackのver.を7.9.1=>8.1.0へ変更
• 2020/09/17
  • Elasctic Stackのver.を7.7=>7.9.1へ変更
  • Docker Compose(Mac)のver.を1.25.5=>1.27.2で動作確認
• 2020/06/07
  • Elasctic Stackのver.を6.3.1=>7.7へ変更
  • Docker Compose(Mac)のver.を1.22.0=>1.25.5で動作確認

GitHub

• https://github.com/sugikeitter/elasticsearch-kibana-docker

環境

• Elasticsearch 8.1.0
• Kibana 8.1.0
• Docker version 20.10.7
• Docker Compose 1.29.2

必要なファイル

.
├── docker-compose.yml
└── .env # PASSWORD の設定が必要

動作確認

起動

以下の手順でElasticsearchとKibanaのコンテナを起動させる

## リポジトリをcloneして、docker-compose.ymlが配置されているディレクトリに移動
$ git clone https://github.com/sugikeitter/elasticsearch-kibana-docker.git
$ cd elasticsearch-kibana-docker

## ELASTIC_PASSWORD と KIBANA_PASSWORD を設定
vi .env

## docker-compose.ymlからDockerイメージをビルドして起動
$ docker-compose up -d

## docker-compose.ymlからDockerイメージをビルドして起動（起動時のログが見たい場合）
$ docker-compose up

## クラスターを停止
$ docker-compose down

## クラスターを停止して起動したリソースを削除
$ docker-compose down -v

起動時のよくあるエラー

• docker-compose up して max virtual memory areas vm.max_map_count [XXXXX] is too low, increase to at least [262144] が出た場合、以下の設定でカーネル設定を変更する

$ sysctl -w vm.max_map_count=262144

Kibanaへ接続

• ブラウザでhttp://localhost:5601/へアクセスすると、起動に成功している場合は以下の画面が表示される

• 以下を入力して「Log in」
  • Username : elastic
  • Password : .env ファイルの ELASTIC_PASSWORD に設定した値

docker-compose.ymlの設定について

今回作成したdocker-compose.ymlはこちら

services

• この下にコンテナを定義していく
• ここで定義したservice名はコンテナ間で通信する時のホスト名のような役割になる
  • 下で出てくるcontainer_nameと違い、Docker Composeで利用される名称
  • ElasticSearchの設定であるnode.nameやdiscovery.seed_hostsの値をコンテナ間の通信する時の名前として利用するようなので、serviceの名前とこの設定値は合わせておいた方が良い
• 今回の場合だとes01, es02, es03, kibana01という4つ定義している

environment

• 環境変数を追加することができる
  • 今回はES_JAVA_OPTSというElasticsearchで利用されるJava起動引数を追加で設定した
    • Elasticsearchとしてはjvm.optionsを利用すればJava起動引数を一括でまとめることもできる
    • 今回はデフォルトのjvm.optionsにヒープサイズだけ追加したかった(のとenvironment設定も使って見たかった)ため、これを利用した

ulimits

• コンテナのulimitコマンドで設定できる値をデフォルト値から上書きする

volumes

• ホスト側のファイルをコンテナ側へ渡したりできる
• HOST:CONTAINERの順で設定
• トップレベルのvolumesに名前を定義することで以下のことができる
  • 複数サービスをまたがってボリュームを利用
  • ホスト側へデータを永続化

port

• 公開するポートの設定
• HOST:CONTAINERの順で設定
• 今回はes0*はそれぞれポート9200を利用してプロセスを立ち上げているが、ホストマシン経由でコンテナへアクセスする場合にlocalhost:920[1,2,3]でそれぞれのコンテナのElasticsearchへアクセスできるように設定している
  • localhost:9201->es01:9200
  • localhost:9202->es02:9200
  • localhost:9203->es03:9200

参考

• Install Elasticsearch with Docker
• Running Kibana on Docker
• Compose file version 3 reference
• はじめての Elasticsearch - Qiita
• Dockerを利用して Elasticsearch + Kibana の環境を作る - Qiita