TestKube Maven Executor 技术文档

镜像概述和主要用途

TestKube Maven Executor 是 TestKube 平台的专用测试执行器，用于在 TestKube 环境中运行 Maven 目标（goals）。该执行器支持从 Git 仓库拉取 Maven 项目代码，集成 TestKube 的测试管理能力，实现测试的创建、执行与监控，适用于 Kubernetes 集群中的 Maven 项目自动化测试场景。

核心功能和特性

• Maven 目标执行：支持运行各类 Maven 目标（如 test、package 等），满足项目构建、测试需求。
• TestKube 集成：无缝对接 TestKube 测试生命周期管理，支持测试的创建、运行、日志查看及结果追踪。
• Git 仓库支持：通过 Git 地址和分支参数（--git-uri、--git-branch）拉取远程 Maven 项目代码，无需本地代码依赖。
• Kubernetes 兼容：基于 Kubernetes 环境运行，可通过 kubectl 命令行工具直接操作。

使用场景和适用范围

适用于需要在 Kubernetes 集群中通过 TestKube 执行 Maven 项目测试的场景，包括但不限于：

• CI/CD 流程中的自动化测试环节（如单元测试、集成测试）。
• 需要集中管理和监控 Maven 项目测试的开发/测试环境。
• 基于 Git 仓库代码的动态测试执行需求。

使用方法和配置说明

前提条件

• Kubernetes 集群已部署 TestKube 平台。
• 本地环境已安装 kubectl 和 TestKube CLI。

1. 部署 Maven 执行器

首先需在集群中注册并部署 Maven 执行器：

kubectl apply -f examples/maven-executor.yaml

注：examples/maven-executor.yaml 为执行器部署配置文件，需确保文件路径可访问（本地路径或集群内可拉取的 URL）。

2. 创建 Maven 测试

通过以下命令从 Git 仓库创建 Maven 测试任务：

kubectl testkube create test \
  --git-uri <Git仓库地址> \
  --git-branch <分支名称> \
  --type "maven/test" \
  --name <测试名称>

示例：
从 Git 仓库 [***] 的 main 分支创建名为 maven-test 的测试：

kubectl testkube create test \
  --git-uri [***] \
  --git-branch main \
  --type "maven/test" \
  --name maven-test

3. 运行 Maven 测试

创建测试后，通过以下命令执行测试并实时查看日志：

kubectl testkube run test --watch <测试名称>

示例：
运行 maven-test 测试并监控日志：

kubectl testkube run test --watch maven-test

配置参数说明

创建测试时的核心参数

运行测试时的核心参数

问题反馈与增强建议

如遇功能问题或需提出改进建议，请通过 TestKube 主仓库反馈：

• Issue 提交
• 讨论区

更多信息

• TestKube 主仓库：[***]
• 官方文档：[***]
• 社区支持：Slack 频道