DockerコンテナでKibanaを実行する

Kibana の Docker イメージは、Elastic 公式 Web サイトの Docker イメージ ウェアハウスから取得できます。このイメージは X-Pack にパッケージ化されています。

X-Pack はこのイメージにプリインストールされています。X-Pack がインストールされると、Kibana は同じく X-Pack を備えた Elasticsearch クラスターに接続します。

画像の取得

Kibana Docker イメージを取得するには、docker pull コマンドを Elastic Docker リポジトリに送信します。

コマンドは次のとおりです。

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

Docker での Kibana の構成

Docker イメージには、Kibana を構成するためのいくつかの方法が用意されています。従来の方法はKibana の設定で説明した設定ファイル kibana.ymlを与えることですが、環境変数を使用して設定項目を定義することもできます。

バインディング構成

Docker で Kibana を構成する 1 つの方法は、バインディング構成ファイル kibana.yml を使用することです。docker-compose ツールを使用して次のようにバインドします。

services:
  kibana:
    image: docker.elastic.co/kibana/kibana:6.0.0
    volumes:
      - ./kibana.yml:/usr/share/kibana/config/kibana.yml

環境変数の設定

Docker では、環境変数を使用して Kibana を設定できます。環境変数は次のとおりです。

表 1. Docker 環境変数

環境変数	キバナの設定
ELASTICSEARCH_CUSTOMHEADERS	elasticsearch.customHeaders
ELASTICSEARCH_PASSWORD	elasticsearch.パスワード
ELASTICSEARCH_PINGTIMEOUT	elasticsearch.pingタイムアウト
ELASTICSEARCH_PRESERVEHOST	elasticsearch.preserveHost
ELASTICSEARCH_REQUESTHEADERSWHITELIST	elasticsearch.requestHeadersWhitelist
ELASTICSEARCH_REQUESTTIMEOUT	elasticsearch.requestTimeout
ELASTICSEARCH_SHARDTIMEOUT	elasticsearch.shardTimeout
ELASTICSEARCH_SSL_CA	elasticsearch.ssl.ca
ELASTICSEARCH_SSL_CERT	elasticsearch.ssl.cert
ELASTICSEARCH_SSL_KEY	elasticsearch.ssl.key
ELASTICSEARCH_SSL_VERIFY	elasticsearch.ssl.verify
ELASTICSEARCH_STARTアップタイムアウト	elasticsearch.startupTimeout
ELASTICSEARCH_URL	elasticsearch.url
ELASTICSEARCH_USERNAME	elasticsearch.ユーザー名
KIBANA_DEFAULTAPPID	kibana.defaultAppId
KIBANA_INDEX	キバナ.インデックス
LOGGING_DEST	ロギング.dest
LOGGING_QUIET	ロギング.静か
LOGGING_SILENT	ロギング.サイレント
LOGGING_VERBOSE	ロギング.詳細
OPS_INTERVAL	運用間隔
PID_FILE	pid.ファイル
サーバー_ベースパス	サーバー.ベースパス
サーバー_ホスト	サーバー.ホスト
SERVER_MAXPAYLOADBYTES	サーバー.maxPayloadBytes
サーバーの名前	サーバーの名前
サーバポート	サーバポート
SERVER_SSL_CERT	サーバー.ssl.cert
SERVER_SSL_KEY	サーバー.SSL.キー
XPACK_MONITORING_ELASTICSEARCH_URL	xpack.monitoring.elasticsearch.url
XPACK_MONITORING_ELASTICSEARCH_USERNAME	xpack.monitoring.elasticsearch.ユーザー名
XPACK_MONITORING_ELASTICSEARCH_PASSWORD	xpack.monitoring.elasticsearch.パスワード
XPACK_MONITORING_ENABLED	xpack.monitoring.enabled
XPACK_MONITORING_MAX_BUCKET_SIZE	xpack.monitoring.max_bucket_size
XPACK_MONITORING_MIN_INTERVAL_SECONDS	xpack.monitoring.min_interval_秒
XPACK_MONITORING_NODE_RESOLVER	xpack.monitoring.node_resolver
XPACK_MONITORING_REPORT_STATS	xpack.monitoring.report_stats
XPACK_MONITORING_KIBANA_COLLECTION_ENABLED	xpack.monitoring.kibana.collection.enabled
XPACK_MONITORING_KIBANA_COLLECTION_INTERVAL	xpack.monitoring.kibana.collection.interval
XPACK_MONITORING_UI_CONTAINER_ELASTICSEARCH_ENABLED	xpack.monitoring.ui.container.elasticsearch.enabled
XPACK_SECURITY_ENABLED	xpack.security.enabled
XPACK_SECURITY_COOKIENAME	xpack.security.cookie名
XPACK_SECURITY_ENCRYPTIONKEY	xpack.security.encryptionKey
XPACK_SECURITY_SECURECOOKIES	xpack.security.secureCookies
XPACK_SECURITY_SESSIONTIMEOUT	xpack.security.sessionTimeout

这些变量可以像下面这样，用 docker-compose 设置：

services:
  kibana:
    image: docker.elastic.co/kibana/kibana:6.0.0
    environment:
      SERVER_NAME: kibana.example.org
      ELASTICSEARCH_URL: http://elasticsearch.example.org

优先使用环境变量，然后是配置文件 kibana.yml 中的配置项。

Docker 默认值

使用 Docker 时，下面的配置项有不同的默认值 ：

server.host	"0"
elasticsearch.url	http://elasticsearch:9200
elasticsearch.username	elastic
elasticsearch.password	changeme
xpack.monitoring.ui.container.elasticsearch.enabled	true

这些配置项的默认值在 kibana.yml 中设置。可以通过 自定义 kibana.yml 或者 环境变量覆盖这些默认值。