openzipkin/zipkin-elasticsearch6

zipkin-elasticsearch6镜像文档

镜像概述

zipkin-elasticsearch6是OpenZipkin Docker镜像系列的一部分，专为提供Elasticsearch 6作为Zipkin的存储后端而设计。该镜像属于测试性质，主要用于开发、学习和探索场景，旨在帮助用户快速搭建包含Zipkin与Elasticsearch 6集成的测试环境，无需手动配置完整的Elasticsearch 6实例。

核心功能与特性

• 存储后端集成：提供预配置的Elasticsearch 6环境，作为Zipkin的存储后端，支持追踪数据的存储与查询
• 测试便利性：简化Zipkin与Elasticsearch 6集成的测试流程，无需手动部署和配置Elasticsearch 6
• 开发辅助：帮助开发者在本地环境验证Zipkin在Elasticsearch 6存储配置下的功能表现
• 轻量探索：支持快速搭建临时Zipkin系统，用于功能演示和学习，降低环境搭建门槛

使用场景与适用范围

• 开发环境测试：在开发过程中测试Zipkin与Elasticsearch 6的集成功能
• 学习与验证：学习Zipkin存储配置机制，验证Elasticsearch 6作为存储后端的兼容性
• 临时功能验证：快速搭建包含Zipkin和Elasticsearch 6的测试系统，进行功能验证和流程演示
• 非生产环境：仅用于开发、测试和探索，不适合生产环境部署

使用方法与配置说明

前提条件

• Docker Engine 1.10.0+
• Docker Compose 1.6.0+

Docker Compose配置

该镜像主要通过Docker Compose配置文件与Zipkin主服务集成，以下是典型使用方式：

基础Elasticsearch 6配置

通过Docker Compose扩展文件启用Elasticsearch 6作为存储后端：

bash
# 使用默认配置文件+Elasticsearch扩展文件
docker-compose -f docker-compose.yml -f docker-compose-elasticsearch.yml up

与Slim版本配合使用

对于zipkin-slim镜像（仅支持Elasticsearch存储），可通过以下命令启动：

bash
# 启动slim版本+Elasticsearch 6存储
docker-compose -f docker-compose-slim.yml -f docker-compose-elasticsearch.yml up

环境变量配置

当Zipkin主服务容器与zipkin-elasticsearch6容器链接（通常命名为"storage"）时，会自动设置以下环境变量：

• STORAGE_PORT_9200_TCP_ADDR：Elasticsearch节点地址（监听9200端口），由容器链接自动注入

其他常用配置环境变量：

• STORAGE_TYPE：需设置为"elasticsearch"，指定使用Elasticsearch作为存储后端
• ES_HOSTS：手动指定Elasticsearch节点地址列表（设置后会忽略STORAGE_PORT_9200_TCP_ADDR）
• JAVA_OPTS：Java运行参数，如堆大小调整（例：-Xms512m -Xmx1g）

注意事项

生产环境限制

该镜像不适合生产环境，OpenZipkin明确指出其仅用于开发和探索。生产环境应使用官方Elasticsearch镜像，并进行 proper 配置（如多节点部署、数据持久化、资源限制等）。

系统配置要求

Elasticsearch 5+及以上版本对虚拟内存有严格要求，需调整内核参数：

bash
# 直接在主机调整内核参数
sudo sysctl -w vm.max_map_count=262144

# 若使用docker-machine/Docker Toolbox/Boot2Docker，通过远程调整
docker-machine ssh default "sudo sysctl -w vm.max_map_count=262144"

兼容性说明

使用时需确保Zipkin版本与Elasticsearch 6兼容，具体可参考Zipkin官方文档的存储配置说明，避免因版本不匹配导致功能异常。

镜像来源

该镜像由OpenZipkin自动构建，官方托管于Quay.io（https://quay.io/repository/openzipkin/zipkin-elasticsearch6%EF%BC%89%EF%BC%8C%E5%B9%B6%E5%90%8C%E6%AD%A5%E8%87%B3Docker Hub。