Bitnami Zipkin 镜像文档

1. 镜像概述和主要用途

Zipkin 是一个分布式追踪系统，用于收集和分析服务架构中的时序数据，帮助排查延迟问题，提供服务调用性能的可见性。Bitnami Zipkin 镜像封装了 Zipkin 服务，提供预配置的部署选项，支持在容器化环境中快速搭建分布式追踪系统。

Zipkin 官方概述

商标说明：本软件列表由 Bitnami 打包。所提及的商标分属各自公司所有，使用这些商标并不意味着任何关联或背书。

2. 核心功能和特性

• 分布式追踪：支持收集服务间调用的追踪数据，包括延迟、错误率等关键指标
• 多存储后端：兼容 Cassandra、Elasticsearch、MySQL 等多种存储方案
• 多收集器支持：内置 HTTP、Kafka、RabbitMQ 等多种数据收集器
• Prometheus 集成：原生支持 Prometheus 指标暴露，便于监控
• 安全加固：遵循 Bitnami 安全最佳实践，减少攻击面
• 灵活配置：支持通过环境变量、配置文件或外部 Secret 进行参数定制
• Kubernetes 原生：提供 Helm Chart，支持在 Kubernetes 集群中一键部署

3. 使用场景和适用范围

• 微服务架构监控：适用于基于微服务架构的应用，追踪跨服务请求流
• 性能问题排查：帮助定位服务调用中的瓶颈和延迟源
• 分布式系统调试：可视化服务依赖关系，辅助分析系统行为
• 开发环境快速部署：通过容器化部署加速开发和测试流程
• 生产环境可观测性：配合监控系统构建完整的分布式追踪解决方案

4. 详细的使用方法和配置说明

4.1 Docker 部署

4.1.1 基本运行 (docker run)

docker run --name zipkin -p 9411:9411 bitnami/zipkin:latest

4.1.2 自定义配置 (docker run)

通过环境变量配置 Zipkin 服务：

docker run --name zipkin -p 9411:9411 \
  -e STORAGE_TYPE=mem \
  -e QUERY_TIMEOUT=10000 \
  -e UI_ENABLED=true \
  bitnami/zipkin:latest

4.1.3 Docker Compose 配置

version: '3'

services:
  zipkin:
    image: bitnami/zipkin:latest
    ports:
      - "9411:9411"
    environment:
      - STORAGE_TYPE=mem
      - QUERY_TIMEOUT=10000
      - UI_ENABLED=true
    restart: unless-stopped

4.2 Kubernetes 部署 (Helm Chart)

4.2.1 前提条件

• Kubernetes 1.23+
• Helm 3.8.0+

4.2.2 快速安装

helm install my-release oci://registry-1.docker.io/bitnamicharts/zipkin

4.2.3 自定义安装

创建自定义 values 文件 custom-values.yaml：

configOverrides:
  UI_ENABLED: true
  QUERY_TIMEOUT: 15000
storageType: mem
service:
  type: NodePort

使用自定义配置安装：

helm install my-release oci://registry-1.docker.io/bitnamicharts/zipkin -f custom-values.yaml

4.2.4 卸载

helm delete my-release

4.3 存储配置

Zipkin 支持多种存储后端，可通过 STORAGE_TYPE 环境变量配置：

4.3.1 内存存储 (开发环境)

configOverrides:
  STORAGE_TYPE: mem

4.3.2 MySQL 存储

storageType: other
configOverrides:
  STORAGE_TYPE: mysql
  MYSQL_DB: zipkin_db
  MYSQL_HOST: mysql
  MYSQL_TCP_PORT: 3306
  MYSQL_USER: zipkin_user
secretConfigOverrides:
  MYSQL_PASSWORD: "your-mysql-password"
cassandra:
  enabled: false

4.3.3 Elasticsearch 存储

storageType: other
configOverrides:
  STORAGE_TYPE: elasticsearch
  ES_HOSTS: [***]
cassandra:
  enabled: false

4.4 收集器配置

4.4.1 Kafka 收集器

configOverrides:
  COLLECTOR_KAFKA_ENABLED: true
  KAFKA_BOOTSTRAP_SERVERS: kafka:9092

4.4.2 RabbitMQ 收集器

configOverrides:
  RABBIT_ADDRESSES: rabbitmq
  RABBIT_USER: rabbitmq_user
secretConfigOverrides:
  RABBIT_PASSWORD: "your-rabbitmq-password"

4.5 Prometheus 监控集成

启用 Prometheus 指标暴露：

metrics:
  enabled: true
  serviceMonitor:
    enabled: true

4.6 TLS 加密配置

创建 TLS 证书 Secret 后配置：

tls:
  enabled: true
  existingSecret: zipkin-tls-cert

5. 配置参数说明

5.1 核心环境变量

5.2 配置覆盖

通过 configOverrides 和 secretConfigOverrides 自定义应用配置：

非敏感配置 (configOverrides)

configOverrides:
  UI_ENABLED: false
  ES_HOSTS: [***]

敏感配置 (secretConfigOverrides)

secretConfigOverrides:
  MYSQL_PASSWORD: "secure-password"
  RABBIT_PASSWORD: "secure-rabbitmq-password"

5.3 资源配置

resources:
  requests:
    cpu: 250m
    memory: 256Mi
  limits:
    cpu: 500m
    memory: 512Mi

5.4 外部配置

使用现有 ConfigMap 和 Secret：

existingConfigmap: my-zipkin-config
existingSecret: my-zipkin-secret

6. 重要注意事项

6.1 Bitnami 镜像仓库变更通知

自 2025 年 8 月 28 日起，Bitnami 将调整其公共镜像仓库策略，推出 Bitnami Secure Images 计划。主要变更包括：

• 社区用户首次可访问安全优化版本的容器镜像
• 逐步弃用非加固的 Debian 基础镜像，免费层将仅提供有限的加固镜像
• 所有现有容器镜像（包括历史版本标签，如 2.50.0、10.6）将迁移至 docker.io/bitnamilegacy 仓库，且不再接收更新
• 生产环境建议使用 Bitnami Secure Images，提供加固容器、更小攻击面、CVE 透明度及企业支持

详细信息请参见 Bitnami Secure Images 公告。

6.2 生产环境最佳实践

• 使用固定标签而非 latest，确保部署一致性
• 启用资源限制，避免资源竞争
• 使用持久化存储确保数据持久性
• 配置 TLS 加密保护数据传输
• 定期更新镜像以获取安全补丁
• 配合监控系统实现全面可观测性

6.3 兼容性注意事项

• Kubernetes 版本需 1.23 及以上
• Helm 版本需 3.8.0 及以上
• 存储后端需符合 Zipkin 官方兼容性要求

7. Kubernetes Helm Chart 参数详情

7.1 全局参数

7.2 常见参数

完整参数列表请参见 Bitnami Zipkin Helm Chart 文档。