kubeshop/testkube-template-executor

TestKube模板执行器

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

什么是执行器（Executor）

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

问题与增强

请关注https://github.com/kubeshop/testkube%EF%BC%8C%E4%BB%A5%E6%8A%A5%E5%91%8A%E4%BB%BB%E4%BD%95https://github.com/kubeshop/testkube/issues%E6%88%96%E5%8F%82%E4%B8%8Ehttps://github.com/kubeshop/testkube/discussions%E3%80%82

实现步骤

1. 创建新仓库

基于此模板创建新仓库。

2. 修改go.mod文件

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

3. 实现自定义Runner

基于https://github.com/kubeshop/testkube/blob/main/pkg/runner/interface.go%E5%AE%9E%E7%8E%B0%E8%87%AA%E5%AE%9A%E4%B9%89Runner%E3%80%82

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规范详情
• https://raw.githubusercontent.com/kubeshop/testkube/main/api/v1/testkube.yaml
• Go输入对象：https://github.com/kubeshop/testkube/blob/main/pkg/api/v1/testkube/model_execution.go
• Go输出对象：https://github.com/kubeshop/testkube/blob/main/pkg/api/v1/testkube/model_executor_output.go

示例

• 本模板仓库（最简单示例）
• https://github.com/kubeshop/testkube-executor-postman
• https://github.com/kubeshop/testkube-executor-cypress
• https://github.com/kubeshop/testkube-executor-curl

TestKube

相关链接

• 文档
• Slack