govcmstesting/ci

GovCMS Tests Docker镜像文档

概述

GovCMS Tests Docker镜像是专为GovCMS（***内容管理系统）设计的标准化测试环境镜像，旨在简化GovCMS相关项目的测试流程。该镜像集成了GovCMS测试所需的核心工具、依赖库及配置，提供一致、隔离的测试环境，帮助开发和测试人员高效验证GovCMS功能、兼容性及稳定性。

核心功能与特性

1. 预装测试工具链

• 集成GovCMS官方推荐的测试框架（如PHPUnit、Behat）及代码质量检查工具
• 包含PHP运行时环境、数据库客户端及Web服务器依赖，满足端到端测试需求
• 预装代码覆盖率分析工具，支持测试结果可视化与报告生成

2. 多类型测试支持

• 支持单元测试：验证GovCMS模块及组件的独立功能逻辑
• 支持集成测试：测试模块间交互及与数据库、外部服务的集成场景
• 支持端到端测试：模拟用户操作流程，验证GovCMS前端与后端协同工作

3. 环境隔离与标准化

• 基于Docker容器化技术，确保测试环境与开发/生产环境隔离，避免环境干扰
• 提供统一的环境配置，消除因本地环境差异导致的测试结果不一致问题
• 支持跨平台运行（兼容x86_64、ARM64架构），适配不同硬件环境

4. 灵活可扩展

• 支持自定义测试命令及配置文件挂载，适配个性化测试需求
• 提供环境变量接口，可动态调整测试参数（如数据库连接、测试范围）

使用场景与适用范围

适用场景

• 开发人员本地测试：快速搭建本地测试环境，验证代码修改对GovCMS功能的影响
• CI/CD流程集成：作为自动化测试环节的运行环境，在代码提交或部署前执行测试用例
• 第三方扩展测试：用于测试为GovCMS开发的插件或模块，验证其与GovCMS核心的兼容性

适用人群

• GovCMS核心开发团队
• 基于GovCMS进行二次开发的技术人员
• 负责GovCMS项目质量保障的测试工程师
• CI/CD流程维护人员

使用方法与配置说明

基础使用命令

通过以下命令启动测试容器，执行默认测试流程：

bash
docker run -it --rm \
  -v /path/to/your/govcms-project:/app \
  govcms/tests:latest \
  run-tests

参数说明：

• -it：启用交互式终端，实时查看测试输出
• --rm：容器退出后自动删除，避免残留容器占用资源
• -v /path/to/your/govcms-project:/app：挂载本地GovCMS项目目录至容器内/app路径，测试本地代码
• govcms/tests:latest：镜像名称及标签（建议使用具体版本号如govcms/tests:1.0.0以确保稳定性）
• run-tests：默认启动命令，执行预设的全量测试流程

自定义测试命令

如需执行特定测试用例或命令，可覆盖默认启动命令：

bash
# 执行单元测试（指定配置文件）
docker run -it --rm \
  -v /path/to/your/govcms-project:/app \
  govcms/tests:latest \
  phpunit --configuration /app/tests/phpunit.xml --testsuite=unit

# 执行Behat端到端测试
docker run -it --rm \
  -v /path/to/your/govcms-project:/app \
  govcms/tests:latest \
  behat --config /app/tests/behat.yml

环境变量配置

通过环境变量调整测试行为，常用配置项如下：

示例：指定集成测试与自定义数据库配置

bash
docker run -it --rm \
  -v /path/to/your/govcms-project:/app \
  -e TEST_TYPE=integration \
  -e DB_HOST=test-db.example.com \
  -e DB_USER=test-user \
  -e DB_PASS=secure-pass \
  govcms/tests:latest

持久化测试报告

通过挂载本地目录保存测试报告，便于后续分析：

bash
docker run -it --rm \
  -v /path/to/your/govcms-project:/app \
  -v /local/report/path:/app/tests/reports \
  govcms/tests:latest

测试报告（如代码覆盖率报告、测试日志）将生成在/local/report/path目录下。

注意事项

1. 环境要求：需安装Docker 19.03+版本，确保Docker服务正常运行
2. 目录权限：挂载本地项目目录时，需保证目录有读写权限，避免容器内权限不足导致测试失败
3. 资源分配：大型测试用例建议通过--memory、--cpus参数分配足够资源（如--memory=4g --cpus=2）
4. 版本管理：生产环境或CI流程中建议使用具体镜像版本号（如govcms/tests:1.0.0），避免latest标签自动更新导致环境变化