clusterhq/fio-tool

FIO-Tools

镜像概述和主要用途

FIO-Tools是Docker化的Fio（Flexible I/O Tester）工具集，用于在Docker环境中进行磁盘I/O性能测试。该工具集包含多个镜像，可执行测试、生成性能图表（如IOPS和带宽）并通过Web服务展示测试结果，适用于评估存储性能、对比不同存储配置等场景。

核心功能和特性

• 执行Fio性能测试，支持本地和远程作业文件（通过JOBFILES/REMOTEFILES环境变量）
• 生成IOPS（每秒I/O操作数）和带宽（BW）性能图表
• 通过Web服务（端口8000）展示测试日志和图表
• 提供"all in one"镜像，简化测试、图表生成和服务部署流程
• 支持Docker卷挂载，测试指定存储卷性能
• 兼容多种Docker环境（常规Docker、docker-machine/boot2docker等）

使用场景和适用范围

• Docker环境下的存储性能评估与基准测试
• 不同存储驱动（如Flocker）的性能对比测试
• 本地或远程Fio作业文件的执行与结果分析
• 多测试场景的结果可视化与共享
• 自动化测试流程中的存储性能验证

详细使用方法和配置说明

基本使用流程

1. 准备Fio作业文件（本地创建或远程URL）
2. 使用fio-tool执行测试
3. 使用fio-genplots生成性能图表
4. 使用fio-plotserve通过Web服务展示结果
5. （推荐）使用"all in one"镜像自动完成上述所有步骤

环境变量说明

• JOBFILES: 本地Fio作业文件名（需挂载到容器/tmp/fio-data目录）
• REMOTEFILES: 远程Fio作业文件URL（多个URL用空格分隔）
• PLOTNAME: 图表名称（用于"all in one"镜像）

卷挂载说明

• /tmp/fio-data: 容器数据目录，用于存储作业文件、测试日志和图表，需通过-v参数挂载本地目录或Docker卷

具体使用示例

1. 执行Fio测试（fio-tool）

本地作业文件：

bash
docker run -v /tmp/fio-data:/tmp/fio-data \
  -e JOBFILES=<你的Fio作业文件名> \
  docker.xuanyuan.run/clusterhq/fio-tool

远程作业文件：

bash
docker run -v /tmp/fio-data:/tmp/fio-data \
  -e REMOTEFILES="http://url.com/<你的作业文件>.fio" \
  -e JOBFILES=<你的Fio作业文件名> \
  docker.xuanyuan.run/clusterhq/fio-tool

2. 生成性能图表（fio-genplots）

生成带宽图表：

bash
docker run -v /tmp/fio-data:/tmp/fio-data \
  docker.xuanyuan.run/clusterhq/fio-genplots \
  -t <图表标题> -b -g -p *_bw*

生成IOPS图表：

bash
docker run -v /tmp/fio-data:/tmp/fio-data \
  docker.xuanyuan.run/clusterhq/fio-genplots \
  -t <图表标题> -i -g -p *_iops*

3. 展示测试结果（fio-plotserve）

bash
docker run -p 8000:8000 -d \
  -v /tmp/fio-data:/tmp/fio-data \
  docker.xuanyuan.run/clusterhq/fio-plotserve

访问http://localhost:8000查看测试日志和图表。

4. "all in one"镜像（自动完成测试、图表和服务）

bash
docker run -p 8000:8000 \
  -v /tmp/fio-data \
  -e REMOTEFILES="http://url.com/<你的作业文件>.fio" \
  -e JOBFILES=<你的Fio作业文件名> \
  -e PLOTNAME=MyTest \
  -d --name MyFioTest \
  docker.xuanyuan.run/clusterhq/fiotools-aio

特殊场景示例

与Docker卷一起使用

bash
docker run \
  -e REMOTEFILES="https://gist.githubusercontent.com/wallnerryan/fd0146ee3122278d7b5f/raw/cdd8de476abbecb5fb5c56239ab9b6eb3cec3ed5/job.fio" \
  -v /tmp/fio-data:/tmp/fio-data \
  --volume-driver flocker \
  -v myvol1:/myvol \
  -e JOBFILES=job.fio \
  docker.xuanyuan.run/clusterhq/fio-tool

用于docker-machine/boot2docker环境

bash
docker run \
  -e REMOTEFILES="https://gist.githubusercontent.com/wallnerryan/fd0146ee3122278d7b5f/raw/d089b6321746fe2928ce3f89fe64b437d1f669df/job.fio" \
  -e JOBFILES=job.fio \
  -v /Users/用户名/Desktop/fio:/tmp/fio-data \
  docker.xuanyuan.run/clusterhq/fio-tool

注意事项

• 重新运行fio-tool时默认会清理/tmp/fio-data卷数据，如需保留结果请提前备份
• Fio作业文件中需指定directory=/my/mounted/volume以测试Docker卷性能
• 运行多个"all in one"作业时使用-v /tmp/fio-data而非-v /tmp/fio-data:/tmp/fio-data（仅单独运行工具镜像时需显式挂载）

结果展示示例