VSI Common Test images 技术文档

镜像概述

VSI Common Test images是为VSI项目设计的通用测试镜像，旨在提供标准化、一致的测试环境，消除因环境差异导致的测试结果不一致问题。该镜像集成了常用测试工具和依赖组件，简化测试环境配置流程，支持各类自动化测试场景的快速部署与执行。

核心功能与特性

标准化测试环境

• 基于统一基础镜像构建，确保不同开发环境、测试节点及CI/CD流水线中的测试环境一致性
• 预置稳定版本的系统依赖（如Python、Java、Node.js等运行时），避免版本冲突

集成常用测试工具

• 包含单元测试工具（JUnit、pytest等）、接口测试工具（Postman、curl等）、UI测试工具（Selenium等）
• 集成测试报告生成工具，支持JUnit XML、HTML等多种报告格式

灵活的配置能力

• 支持通过环境变量自定义测试参数（如测试环境地址、超时时间等）
• 提供配置文件挂载接口，允许注入自定义测试用例和配置

轻量级与高效性

• 基于精简基础镜像构建，优化镜像体积，减少资源占用
• 预置测试流程优化脚本，缩短测试执行启动时间

使用场景与适用范围

开发阶段本地测试

• 开发人员在本地开发环境中快速启动标准化测试环境，验证代码功能
• 支持单机多实例运行，满足并行测试需求

CI/CD流水线集成

• 作为CI/CD流程中的测试环节执行环境，自动运行测试用例并输出报告
• 兼容主流CI/CD平台（Jenkins、GitLab CI、GitHub Actions等）

自动化测试执行

• 支持定时任务触发的自动化测试，如夜间回归测试
• 配合测试管理平台，实现测试用例、执行结果的全流程跟踪

使用方法与配置说明

镜像拉取

通过Docker Hub拉取最新版本镜像：

bash
docker pull vsi/common-test:latest

如需指定版本，可替换latest为具体版本标签（如v1.2.0）：

bash
docker pull vsi/common-test:v1.2.0

基本运行方式

启动交互式测试环境：

bash
docker run -it --rm vsi/common-test:latest /bin/bash

环境变量配置

通过-e参数注入环境变量，自定义测试行为：

示例：指定测试环境为test，超时时间1800秒，输出报告到/custom-reports：

bash
docker run -it --rm \
  -e TEST_ENV=test \
  -e TEST_TIMEOUT=1800 \
  -e REPORT_OUTPUT_PATH=/custom-reports \
  -v $(pwd)/reports:/custom-reports \
  vsi/common-test:latest

挂载测试用例

通过目录挂载将本地测试用例注入容器：

bash
docker run -it --rm \
  -v $(pwd)/test-cases:/app/test-cases \
  vsi/common-test:latest \
  run-tests.sh /app/test-cases

CI/CD集成示例（GitLab CI）

在.gitlab-ci.yml中配置测试阶段：

yaml
stages:
  - test

test_job:
  stage: test
  image: vsi/common-test:latest
  variables:
    TEST_ENV: test
    REPORT_OUTPUT_PATH: /builds/$CI_PROJECT_PATH/test-reports
  script:
    - run-tests.sh /builds/$CI_PROJECT_PATH/test-cases
  artifacts:
    paths:
      - test-reports/
    expire_in: 1 week

注意事项

1. 版本选择：生产环境建议使用具体版本标签（如v1.2.0）而非latest，确保测试环境稳定性
2. 资源配置：根据测试负载调整容器CPU/内存资源限制（通过--cpus、--memory参数）
3. 权限管理：挂载宿主机目录时确保容器内用户有读写权限，可通过-u参数指定用户ID
4. 自定义扩展：如需添加项目特定工具，可基于此镜像构建自定义镜像，示例Dockerfile：

   dockerfile
   FROM vsi/common-test:latest
   RUN apt-get update && apt-get install -y custom-tool
   

版本信息

• 最新稳定版本：v1.2.0
• 基础镜像：ubuntu:20.04
• 内置主要工具版本：
  • Python: 3.9
  • OpenJDK: 11
  • Node.js: 16.x
  • Selenium: 4.1.0
  • Postman CLI: 9.15.2