stakater/kibana-with-consul-template

Kibana with Consul Template

镜像概述和主要用途

这是一个集成Consul Template的Kibana Docker容器，旨在通过Consul服务动态配置Kibana。Consul Template会查询Consul实例并更新指定的模板文件，支持在模板更新后执行自定义命令（如重启Kibana服务），适用于需要动态调整Kibana配置的场景。

支持的标签

• 5.2-0.18.0、latest - Kibana v5.2 与 Consul Template v0.18.0 (https://github.com/stakater/dockerfile-kibana-with-consul-template/blob/master/5.2/Dockerfile)
• 4.5-0.18.0 - Kibana v4.5 与 Consul Template v0.18.0 (https://github.com/stakater/dockerfile-kibana-with-consul-template/blob/master/4.5/Dockerfile)

核心功能和特性

• 动态配置：通过Consul Template从Consul获取配置，自动更新Kibana配置文件
• 自动重启：模板更新后可自动重启Kibana服务，确保配置生效
• 灵活集成：与Consul生态无缝集成，支持Consul DNS解析

使用方法

基本运行命令

bash
docker run stakater/kibana-with-consul-template:latest

工作原理

容器启动后，Consul Template进程会执行以下操作：

bash
consul-template -consul-addr=$CONSUL_URL -template="/templates/kibana.ctmpl:/opt/kibana/config/kibana.yml:service kibana restart"

• 查询指定的Consul实例（通过CONSUL_URL环境变量配置）
• 将模板文件/templates/kibana.ctmpl渲染为Kibana配置文件/opt/kibana/config/kibana.yml
• 配置文件更新后，自动执行service kibana restart重启服务

Consul键值配置

需在Consul中配置以下键值对以自定义Kibana设置：

1. Elasticsearch URL

• Consul键：/kibana/elasticsearchURL
• 用途：指定Kibana连接的Elasticsearch实例URL，需包含完整路径和端口
• 示例值：http://elasticsearch-9200:9200（可使用Consul DNS条目）
• 默认值：若未配置，默认使用http://elasticsearch:9200

2. 基础路径（代理场景）

• Consul键：/kibana/basePath
• 用途：当Kibana部署在代理后，指定其访问路径（不可以斜杠结尾）
• 示例值：/kibana

使用场景和适用范围

• 需要动态调整Kibana配置的分布式环境
• 使用Consul作为服务发现和配置中心的架构
• 多环境（开发、测试、生产）Kibana配置隔离需求