alpine/bombardier

alpine/bombardier 镜像文档

镜像概述和主要用途

alpine/bombardier 是一个基于 Alpine Linux 的 Docker 镜像，集成了 HTTP 负载测试工具 bombardier。该镜像会自动跟踪 bombardier 的最新发布版本，并通过 CI/CD 流程自动构建和更新，确保用户始终能获取到包含最新功能的 bombardier 工具。主要用途是对 HTTP 服务进行高性能负载测试，快速评估服务在高并发场景下的响应时间、吞吐量、错误率等关键指标。

核心功能和特性

• 自动构建与更新：通过 CI 定时任务监控 bombardier 官方发布，自动触发镜像构建，确保镜像版本与工具最新版本同步。
• 轻量级基础：基于 Alpine Linux，镜像体积小，启动速度快，资源占用低。
• 完整功能支持：包含 bombardier 全部原生功能，支持自定义并发连接数、测试持续时间、请求方法、 headers 等参数。

使用场景和适用范围

• HTTP 服务性能测试：开发或测试阶段，对 Web 服务、API 接口进行负载测试，验证服务在高并发下的稳定性。
• 性能瓶颈定位：通过调整并发连接数、测试时长等参数，模拟不同流量场景，评估服务的最大承载能力。
• 自动化测试集成：可集成到 CI/CD 流程中，作为性能测试环节的工具，确保服务迭代后性能达标。

使用方法和配置说明

基本用法

通过 docker run 命令直接运行镜像，即可调用 bombardier 工具。基本命令格式：

bash
docker run --rm -it docker.xuanyuan.run/alpine/bombardier [bombardier 参数] <目标 URL>

参数说明

• --rm：测试结束后自动删除容器，避免残留。
• -it：分配交互式终端，确保输出正常显示。
• [bombardier 参数]：bombardier 工具的测试参数（如并发连接数、持续时间等），具体可通过 --help 查看完整列表。

示例：对 HTTP 服务进行负载测试

以下示例模拟 200 个并发连接，持续测试 10 秒，目标 URL 为 http://www.google.com：

bash
docker run -ti --rm docker.xuanyuan.run/alpine/bombardier -c 200 -d 10s -l http://www.google.com

输出说明

执行上述命令后，将输出测试统计结果，包括：

• 请求速率（Reqs/sec）：平均每秒请求数，含标准差和最大值。
• 延迟（Latency）：平均延迟、标准差、最大值，以及分位数分布（50%、75%、90%、99%）。
• HTTP 状态码分布：各状态码（1xx/2xx/3xx/4xx/5xx）的请求数量。
• 吞吐量（Throughput）：每秒数据传输量。

查看完整参数

通过 --help 查看 bombardier 所有支持的参数：

bash
docker run --rm -it docker.xuanyuan.run/alpine/bombardier --help

自动构建机制

该镜像通过以下流程实现自动更新，确保与 bombardier 最新版本同步：

1. 定时触发：Travis CI 定时任务每日在 master 分支运行构建流程。
2. 版本检查：通过 GitHub REST API 检查 bombardier 是否有新发布标签。
3. 镜像标签匹配：通过 Docker Hub REST API 比对现有镜像标签与最新发布版本。
4. 构建与推送：若版本不一致，自动构建含最新版本的镜像，并推送至 Docker Hub。

镜像标签说明

• latest：对应 bombardier 最新发布版本，通过自动构建流程更新。
• 历史版本标签：与 bombardier 官方发布标签一一对应（如 v1.2.3），可通过 Docker Hub 查看完整标签列表。

注：bombardier 官方文档可提供更详细的参数说明和高级用法，建议结合使用以满足复杂测试需求。