TestKube模板执行器

TestKube模板执行器是TestKube的测试执行器框架，可作为创建新执行器的基础构建块。

什么是执行器（Executor）

执行器是包装在Docker容器中的程序，它接收基于OpenAPI的JSON文档（testube.Execution）作为输入，并返回JSON输出行流（testkube.ExecutorOutput），每行输出都简单包装在该JSON中，类似于结构化日志的理念。

问题与增强

请关注TestKube主仓库，以报告任何问题或参与讨论。

实现步骤

1. 创建新仓库

基于此模板创建新仓库。

2. 修改go.mod文件

将项目中的github.com/kubeshop/testkube-executor-template替换为你的包路径。

3. 实现自定义Runner

基于Runner接口实现自定义Runner。

4. 修改Dockerfile

使用你想要的测试框架/库的基础镜像。

5. 构建并推送镜像

构建Docker镜像并推送到镜像仓库。

6. 在集群中注册执行器自定义资源

yaml
apiVersion: executor.testkube.io/v1
kind: Executor
metadata:
  name: postman-executor
  namespace: testkube
spec:
  executor_type: job
  image: kubeshop/testkube-template-executor:0.0.1
  types:
  - example/test

架构

该执行器模板提供了基于Go编程语言的TestKube库来编写新执行器的基础构建块，但你不仅限于Go，还可以使用其他编程语言如Rust、Javascript、Java或Clojure。

你只需遵循以下规范：

• 输入：遵循testkube.Execution的OpenAPI规范（以JSON形式作为第一个参数传递）
• 输出：所有输出应为带有testkube.ExecutorOutput规范的JSON行
• 执行结果：在测试执行成功（或失败）后，需附加包含ExecutionResult的最终ExecutorOutput

资源链接

• OpenAPI规范详情
• YAML规范文件
• Go输入对象：testkube.Execution
• Go输出对象：testkube.ExecutorOutput

示例

• 本模板仓库（最简单示例）
• Postman执行器
• Cypress执行器
• Curl执行器

TestKube

相关链接

• 文档
• Slack