kubeshop/testkube-k6-executor

TestKube k6 Executor 文档

!https://raw.githubusercontent.com/kubeshop/testkube/main/assets/testkube-color-gray.png

概述

TestKube k6 Executor是一个测试执行器组件，用于通过TestKube在Kubernetes环境中运行k6负载测试。它提供了与TestKube生态系统的无缝集成，支持k6测试脚本的管理、执行和结果可视化。

核心功能与特性

• 作为TestKube的测试执行器，支持运行k6负载测试
• 兼容标准k6测试脚本语法和功能
• 支持本地文件、Git仓库等多种测试脚本来源
• 可集成InfluxDB与Grafana实现测试性能数据的存储与可视化
• 提供命令行界面管理测试生命周期（创建、运行、监控）

使用场景与适用范围

• 需要在Kubernetes集群中执行API或服务负载测试的场景
• 通过TestKube统一管理各类测试（包含k6负载测试）的团队
• 需对系统进行性能评估和压力测试并可视化结果的场景
• 开发和测试团队进行持续性能验证的CI/CD流程集成

使用方法与配置说明

部署执行器

在Kubernetes集群中注册并部署执行器，如需性能数据可视化可同时部署InfluxDB和Grafana：

bash
# 部署k6执行器
kubectl apply -f examples/k6-executor.yaml

# 部署InfluxDB和Grafana（用于性能数据可视化）
# 参考: https://k6.io/docs/results-visualization/influxdb-+-grafana/
kubectl apply -f examples/k6-influxdb-grafana.yaml

编写测试脚本

测试脚本遵循k6标准语法，详情可参考k6官方文档。简单示例：

javascript
import http from 'k6/http';
import { sleep } from 'k6';

export default function () {
  http.get('https://docs.testkube.io');
  sleep(1);
}

创建与运行测试

基本工作流程

bash
# 1. 创建测试（从本地文件）
kubectl testkube create test --file examples/k6-test-script.js --type "k6/script" --name k6-test-script

# 2. 运行测试并实时监控
kubectl testkube run test --watch k6-test-script

示例

从Git仓库加载测试脚本

bash
# 从Git仓库创建测试
kubectl testkube create test \
  --git-uri https://github.com/kubeshop/testkube-executor-k6.git \
  --git-branch main \
  --git-path examples \
  --type "k6/script" \
  --name k6-test-script-git

# 运行Git仓库中的测试脚本
kubectl testkube run test --args examples/k6-test-script.js --watch k6-test-script-git

本地测试执行

bash
# 创建本地测试（使用k6/run类型，k6/script已 deprecated）
kubectl testkube create test \
  --file examples/k6-test-script.js \
  --type "k6/run" \
  --name k6-local-test

使用k6 Cloud执行测试

需提供k6 Cloud API令牌作为参数：

bash
# 创建k6 Cloud测试
kubectl testkube create test \
  --file examples/k6-test-script.js \
  --type "k6/cloud" \
  --name k6-cloud-test

# 运行k6 Cloud测试（替换<YOUR_K6_CLOUD_API_TOKEN>为实际令牌）
kubectl testkube run test \
  --param K6_CLOUD_TOKEN=<YOUR_K6_CLOUD_API_TOKEN> \
  --watch k6-cloud-test

问题与增强

有关问题报告和功能增强，请访问https://github.com/kubeshop/testkube%EF%BC%9A

• https://github.com/kubeshop/testkube/issues
• https://github.com/kubeshop/testkube/discussions

相关资源

• https://github.com/kubeshop/testkube
• k6官方文档
• TestKube文档

!Release !Go version

!Docker builds !Code build !Release date

!*** !Slack

文档 | Slack