loadimpact/k6

k6 Docker镜像文档

镜像概述

【重要提示】此镜像已弃用，其支持将于2023年12月31日后停止。该镜像已被https://hub.docker.com/r/grafana/k6%E6%9B%BF%E4%BB%A3%E3%80%82%E8%AF%B7%E6%9B%B4%E6%96%B0%E6%82%A8%E7%9A%84%E8%84%9A%E6%9C%AC%E4%BB%A5%E4%BD%BF%E7%94%A8https://hub.docker.com/r/grafana/k6%EF%BC%8C%E4%BB%A5%E7%BB%A7%E7%BB%AD%E4%BD%BF%E7%94%A8k6%E7%9A%84%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E3%80%82

k6是一款现代负载测试工具，基于性能和测试行业多年经验构建。它提供简洁易用的脚本API、本地与云执行能力、灵活的配置选项，可通过CLI或REST API进行命令与控制，重新定义21世纪的负载测试方式。

!https://github.com/grafana/k6/raw/master/assets/k6-demo.gif

核心功能和特性

• ES6 JS脚本支持：支持模块，便于组织内代码复用
• 一切皆代码：测试逻辑和配置选项均通过JS实现，便于版本控制
• 自动化友好：提供检查（类似断言）和阈值，支持灵活的CI配置
• 多协议支持：HTTP/1.1、HTTP/2和WebSocket
• TLS特性：支持客户端证书、可配置的SSL/TLS版本和密码套件
• 内置功能丰富：包含Cookie、加密、自定义指标、编码、环境变量、JSON处理、HTML表单、文件操作、灵活的执行控制等
• 内置HAR转换器：可将浏览器会话记录为.har文件，并直接转换为k6脚本
• 灵活的指标存储与可视化：支持Grafana仪表板（InfluxDB、TimescaleDB、Prometheus Remote Write或AWS Timestream）、JSON输出或Grafana Cloud
• 云执行与分布式测试：目前仅在Grafana Cloud管理的基础设施上支持，k6原生分布式执行计划在近期推出

更多功能请参见k6文档。

使用场景和适用范围

• 网站和API的性能负载测试
• 系统容量和极限测试
• CI/CD流程中的自动化性能验证
• WebSocket服务性能测试
• 需要模拟真实用户行为的场景测试
• 多协议服务（HTTP/1.1、HTTP/2、WebSocket）的性能评估

使用方法和配置说明

迁移提示

由于此镜像已弃用，强烈建议迁移至https://hub.docker.com/r/grafana/k6%E3%80%82%E4%BB%A5%E4%B8%8B%E4%B8%BA%E5%8E%9F%E9%95%9C%E5%83%8F%E7%9A%84%E5%9F%BA%E6%9C%AC%E4%BD%BF%E7%94%A8%E6%96%B9%E6%B3%95%EF%BC%88%E4%BB%85%E4%BE%9B%E5%8F%82%E8%80%83%EF%BC%8C%E5%BB%BA%E8%AE%AE%E7%9B%B4%E6%8E%A5%E4%BD%BF%E7%94%A8%E6%96%B0%E9%95%9C%E5%83%8F%EF%BC%89%EF%BC%9A

基本使用示例

1. 运行测试脚本

bash
docker run -v $(pwd):/scripts loadimpact/k6 run /scripts/script.js

2. 指定测试选项

bash
docker run loadimpact/k6 run -e BASE_URL=https://test-api.k6.io -u 10 -d 30s /scripts/script.js

关键参数说明

• -v $(pwd):/scripts: 将本地目录挂载到容器内，以便访问测试脚本
• run: 执行测试命令
• -e: 设置环境变量
• -u: 虚拟用户数
• -d: 测试持续时间

注意事项

• 此镜像不再接收更新，可能存在安全风险
• 新功能和bug修复仅在https://hub.docker.com/r/grafana/k6%E4%B8%AD%E6%8F%90%E4%BE%9B
• 请参考官方迁移指南获取详细迁移步骤