Zipkin Azure 镜像文档

1. 镜像概述

本镜像为Quay.io仓库openzipkin/zipkin-azure的镜像副本，用于支持Zipkin分布式追踪系统在Azure云环境中的部署、集成与运行。Zipkin是一款开源的分布式追踪系统，可帮助开发者收集、存储和分析分布式系统中的服务调用链路数据，而本镜像针对Azure环境进行了优化，提供与Azure服务的集成能力。

2. 核心功能与特性

• Azure环境集成：针对Azure云平台设计，支持与Azure系列服务的无缝集成，如Azure Storage（用于追踪数据持久化）、Azure Monitor（用于监控追踪系统状态）、Azure Active Directory（用于访问控制）等。
• Zipkin核心能力：继承Zipkin的基础功能，包括分布式追踪数据的收集、存储、查询和可视化，支持通过HTTP、Kafka等方式接收追踪数据。
• 轻量化部署：基于Docker容器化部署，简化在Azure容器服务（如AKS、App Service Containers）中的部署流程。

3. 使用场景与适用范围

• Azure云环境分布式系统：适用于在Azure公有云、Azure Stack等环境中部署的微服务架构或分布式系统，需要进行服务调用链路追踪和性能分析的场景。
• Azure容器服务部署：可集成到Azure Kubernetes Service (AKS)、Azure Container Instances (ACI) 等容器服务中，作为分布式追踪组件。
• Zipkin与Azure服务联动：需将Zipkin追踪数据存储至Azure Storage、或通过Azure Monitor监控追踪系统健康状态的场景。

4. 使用方法与配置说明

4.1 基本部署

通过docker run命令直接启动容器：

docker run -d --name zipkin-azure -p 9411:9411 mirror.openzipkin/zipkin-azure:latest

• -p 9411:9411：映射Zipkin默认Web端口（9411），用于访问Zipkin UI和API。

4.2 环境变量配置

通过环境变量配置Azure服务集成参数，常用配置如下：

示例（集成Azure Storage）：

docker run -d --name zipkin-azure \
  -p 9411:9411 \
  -e AZURE_STORAGE_ACCOUNT=myaccount \
  -e AZURE_STORAGE_ACCESS_KEY=mykey \
  -e AZURE_STORAGE_CONTAINER=zipkin-data \
  mirror.openzipkin/zipkin-azure:latest

4.3 访问Zipkin UI

容器启动后，通过http://localhost:9411访问Zipkin Web界面，可查看服务依赖图、追踪链路详情等数据。

4.4 集成到Azure Kubernetes Service (AKS)

在AKS中部署时，可通过Kubernetes Deployment配置文件定义容器，示例片段：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: zipkin-azure
spec:
  replicas: 1
  selector:
    matchLabels:
      app: zipkin-azure
  template:
    metadata:
      labels:
        app: zipkin-azure
    spec:
      containers:
      - name: zipkin-azure
        image: mirror.openzipkin/zipkin-azure:latest
        ports:
        - containerPort: 9411
        env:
        - name: AZURE_STORAGE_ACCOUNT
          valueFrom:
            secretKeyRef:
              name: azure-storage-secret
              key: account-name
        - name: AZURE_STORAGE_ACCESS_KEY
          valueFrom:
            secretKeyRef:
              name: azure-storage-secret
              key: access-key

4.5 数据持久化

通过配置Azure Storage相关环境变量，可将追踪数据持久化至Azure Blob Storage，避免容器重启导致数据丢失。