aheadworks/m2test

docker-m2test

镜像概述和主要用途

docker-m2test是一个Docker镜像，用于针对指定Magento 2版本对扩展进行自动化测试。它提供了标准化的测试环境，简化Magento 2扩展的各类测试流程。

核心功能和特性

• 支持多种测试类型：
  • 单元测试（unit）
  • 静态测试（static）
  • Magento编码标准测试（EQP，基于https://github.com/magento/marketplace-eqp%EF%BC%89
  • 市场包验证（使用https://github.com/magento/marketplace-tools%EF%BC%89

使用场景和适用范围

适用于Magento 2扩展开发者，在开发过程中对扩展进行自动化测试，确保代码质量和兼容性，满足Magento市场发布要求。

使用方法和配置说明

基本使用前提

该镜像需针对包含Magento 2扩展的文件夹运行，通过挂载本地目录将扩展代码或包文件提供给容器。

运行单元和静态测试

对Magento 2.3和PHP 7.2运行单元测试

bash
docker run -v /本地扩展文件夹:/data aheadworks/m2test:2.3-7.2 unit /data

说明：-v参数将本地扩展文件夹挂载到容器的/data目录，指定测试类型为unit（单元测试）

运行静态测试并收集JUnit格式结果

bash
docker run -v /本地扩展文件夹:/data -v /本地结果文件夹:/results aheadworks/m2test:2.2-7.1 static /data /results

说明：额外挂载/results目录用于存储测试结果，静态测试结果将输出到该目录

运行单元测试并指定JUnit结果文件路径

bash
docker run -v /本地扩展文件夹:/data -v /本地结果文件夹:/results aheadworks/m2test:2.2-7.1 unit /data /results/unit-tests.xml

说明：单元测试结果将保存为/results/unit-tests.xml（对应本地结果文件夹中的unit-tests.xml）

运行EQP（Magento编码标准）测试

bash
docker run -v /本地扩展文件夹:/data aheadworks/m2test:2.3-7.2 eqp --report=full /data

说明：基于https://github.com/magento/magento-coding-standard%E5%AF%B9%E6%89%A9%E5%B1%95%E8%BF%9B%E8%A1%8C%E6%B5%8B%E8%AF%95%EF%BC%8C--report=full%E5%8F%82%E6%95%B0%E6%8C%87%E5%AE%9A%E8%BE%93%E5%87%BA%E5%AE%8C%E6%95%B4%E6%8A%A5%E5%91%8A

验证市场包

bash
docker run -v /本地包含扩展zip包的文件夹:/data aheadworks/m2test validate_m2_package /data/module-name.zip

说明：验证指定的Magento 2扩展zip包是否符合市场发布要求，需将包含zip包的本地文件夹挂载到/data目录