kubeshop/testkube-backoffice

镜像概述

Testkube Backoffice 镜像为 Testkube 测试自动化平台提供官方后台管理界面，旨在通过可视化 Web 界面简化测试资源管理、测试执行监控及结果分析。作为 Testkube 生态的核心组件，该镜像需配合 Testkube API 服务使用，为用户提供直观的操作入口，降低命令行操作门槛，提升测试管理效率。

核心功能与特性

• 测试资源全生命周期管理：支持创建、编辑、删除测试（Test）、测试套件（Test Suite）、测试执行（Execution）等核心资源，统一管理测试元数据。
• 实时测试执行监控：可视化展示测试执行状态（待处理、运行中、成功、失败等），支持查看实时日志、执行时长及资源占用情况。
• 测试结果可视化与分析：通过图表、日志详情及趋势分析呈现测试结果，支持按时间、状态、测试类型等维度筛选历史执行记录。
• 无缝集成 Testkube API：自动同步 Testkube API 服务数据，确保操作实时生效，支持多版本 API 兼容。
• 轻量级容器化部署：基于 Alpine 基础镜像构建，体积小、启动快，支持单机 Docker 或 Kubernetes 环境部署。

使用场景

• 开发团队：在 CI/CD 流程中快速创建测试用例、调试测试逻辑，验证代码变更的有效性。
• 测试团队：日常管理测试套件、批量执行测试任务，集中监控多环境测试执行进度与失败原因。
• 运维团队：配置 Testkube 连接参数，管理多集群测试资源，简化平台维护与版本升级。

使用方法与配置说明

前提条件

• 已部署 Testkube API 服务（testkube-api），且 Backoffice 可网络访问该服务（默认 API 端口为 8088）。
• 本地环境已安装 Docker Engine（20.10+）或兼容容器运行时。

基本部署（Docker Run）

通过 docker run 命令快速启动 Backoffice 容器：

bash
docker run -d \
  --name testkube-backoffice \
  -p 8080:8080 \
  -e TESTKUBE_API_URL=http://<testkube-api-ip>:8088 \  # 替换为实际 Testkube API 地址
  testkube/backoffice:latest

参数说明：

• -p 8080:8080：端口映射，将容器内 8080 端口映射至主机 8080 端口（可根据需求修改主机端口）。
• TESTKUBE_API_URL：必填参数，指定 Testkube API 服务的基础 URL（需包含协议，如 http://testkube-api:8088 或 https://api.testkube.example.com）。

环境变量配置

通过环境变量自定义服务行为，常用配置如下：

访问与验证

1. 部署完成后，通过浏览器访问 http://<主机IP>:<映射端口>（如 http://localhost:8080）。
2. 首次访问时，界面底部将显示 API 连接状态，提示“Connected to Testkube API”即表示部署成功。
3. 登录后可通过左侧导航栏访问测试管理、执行监控、结果分析等功能模块。

注意事项

• 数据存储：Backoffice 本身不存储业务数据，所有测试资源数据均通过 Testkube API 从后端数据库（如 MongoDB）获取，需确保 Testkube API 服务正常连接数据库。
• 生产环境部署：建议通过 Kubernetes（配合 Testkube Operator）部署，利用 Service 实现 API 服务发现，通过 Ingress 配置域名与 TLS 加密。
• 版本兼容性：需确保 Backoffice 版本与 Testkube API 版本匹配，避免因接口变更导致功能异常（推荐使用相同版本标签，如 v1.15.0）。