zipkin-mysql 镜像文档

镜像概述

概述

zipkin-mysql 是一个小型 MySQL 镜像，与其他 Zipkin 系列镜像共享基础层以减少存储空间占用。该镜像为 [***] 的镜像，专为 Zipkin 分布式追踪系统设计。

主要用途

为 Zipkin 分布式追踪系统提供数据库支持，用于存储追踪数据（如调用链信息、服务依赖关系等），支持 Zipkin 的数据持久化和查询功能。

核心功能和特性

• 轻量级设计：小型化镜像，减少资源占用，适合快速部署。
• Zipkin 兼容性：与其他 Zipkin 镜像共享基础层，降低多镜像部署的存储空间消耗。
• 预配置环境：默认包含 Zipkin 所需的数据库（zipkin）和用户（zipkin），无需手动初始化，可直接集成。

使用场景和适用范围

使用场景

• 作为 Zipkin 分布式追踪系统的后端数据库，存储追踪数据。
• 开发、测试环境中快速搭建 Zipkin 服务，简化数据库配置流程。

适用范围

• 需 MySQL 数据库支持的 Zipkin 部署场景。
• 轻量级生产环境或对资源占用敏感的场景（如边缘计算、微服务测试集群）。

使用方法和配置说明

运行镜像

通过 docker run 命令直接启动镜像，默认会初始化 zipkin 数据库及用户：

docker run -d --name zipkin-mysql -p 3306:3306 quay.io/openzipkin/zipkin-mysql

• -d：后台运行容器。
• --name zipkin-mysql：指定容器名称为 zipkin-mysql。
• -p 3306:3306：映射容器 3306 端口到主机，允许外部访问数据库。

连接数据库

本地连接（容器内或主机直接访问）

若主机已安装 MySQL 客户端，可通过以下命令连接容器内数据库：

mysql -h localhost -P 3306 -u zipkin -pzipkin -D zipkin

• localhost：主机地址（若容器与主机端口映射正常）。
• -P 3306：映射后的主机端口。
• -u zipkin：默认用户名（预配置）。
• -pzipkin：默认密码（预配置）。
• -D zipkin：默认数据库名（预配置）。

远程连接（如通过 docker-machine）

若使用 docker-machine 管理 Docker 主机，需先获取主机 IP，再连接数据库：

# 获取 docker-machine 主机 IP
DOCKER_MACHINE_IP=$(docker-machine ip)
# 连接数据库
mysql -h $DOCKER_MACHINE_IP -P 3306 -u zipkin -pzipkin -D zipkin

Docker Compose 配置示例

在 Zipkin 部署中，可通过 docker-compose.yml 集成该镜像，与 Zipkin 服务联动：

version: '3'
services:
  zipkin-mysql:
    image: quay.io/openzipkin/zipkin-mysql
    container_name: zipkin-mysql
    ports:
      - "3306:3306"
    volumes:
      - mysql-data:/var/lib/mysql  # 挂载数据卷，持久化存储数据
    restart: always

  zipkin:
    image: openzipkin/zipkin
    container_name: zipkin
    ports:
      - "9411:9411"
    environment:
      - STORAGE_TYPE=mysql
      - MYSQL_HOST=zipkin-mysql
      - MYSQL_USER=zipkin
      - MYSQL_PASS=zipkin
      - MYSQL_DB=zipkin
    depends_on:
      - zipkin-mysql
    restart: always

volumes:
  mysql-data:  # 定义数据卷，持久化 MySQL 数据

配置参数说明

默认配置适用于快速集成 Zipkin，无需额外修改。核心参数如下：

注：如需自定义配置（如修改密码、创建新用户），可通过 MySQL 客户端连接后执行 SQL 命令调整，或参考 MySQL 官方镜像文档通过环境变量（如 MYSQL_ROOT_PASSWORD、MYSQL_DATABASE 等）覆盖默认值。