Drupal CI 镜像文档

概述

Drupal CI 是由Drupal官方提供的持续集成工具镜像，专为Drupal生态系统设计。该镜像提供了完整的测试环境和自动化工具链，用于对Drupal模块、主题和核心代码进行全面的质量检测、功能验证和兼容性测试，帮助开发者在开发过程中及早发现并解决问题。

核心功能与特性

主要功能

• 自动化代码质量检测，包括代码规范检查和静态分析
• 功能测试自动化，支持单元测试、集成测试和功能测试
• 兼容性测试，验证代码在不同Drupal版本和PHP环境中的表现
• 自动化构建和测试报告生成

关键特性

• 支持多种测试框架和工具集成
• 可定制的测试工作流配置
• 多版本PHP环境支持
• 与Drupal.org无缝集成
• 容器化设计，确保测试环境一致性

使用场景

适用范围

• Drupal模块和主题开发
• Drupal核心贡献者的代码测试
• 企业Drupal项目的持续集成流程
• 第三方Drupal扩展的质量保证

典型应用场景

• 开发团队在提交代码前进行本地测试
• 自动化检查社区贡献的代码质量
• 在CI/CD管道中集成Drupal代码测试
• 维护多个Drupal版本兼容性的模块开发

使用方法

基本用法

本地测试环境启动

docker run -it --rm drupalci/webdriver-chromedriver:latest

与Docker Compose集成

version: '3'
services:
  drupalci:
    image: drupalci/webdriver-chromedriver:latest
    volumes:
      - ./your-drupal-code:/var/www/html
    environment:
      - DRUPAL_VERSION=9
      - PHP_VERSION=8.1
      - TEST_TYPE=phpunit

配置参数

环境变量

• DRUPAL_VERSION: 指定Drupal核心版本（如7, 8, 9, 10）
• PHP_VERSION: 指定PHP版本（如7.4, 8.0, 8.1）
• TEST_TYPE: 指定测试类型（phpunit, behat, simpletest等）
• MODULE_NAME: 指定要测试的模块名称
• THEME_NAME: 指定要测试的主题名称
• DB_TYPE: 指定数据库类型（mysql, pgsql, sqlite）

测试执行

运行PHPUnit测试

docker exec -it [container_id] run_tests.sh --type phpunit --module mymodule

运行代码规范检查

docker exec -it [container_id] run_tests.sh --type coder --module mymodule

高级配置

自定义测试配置

可以通过挂载自定义配置文件覆盖默认测试设置：

docker run -it --rm -v ./my_custom_config:/etc/drupalci/config drupalci/webdriver-chromedriver:latest

测试报告输出

测试结果默认输出到容器内的/var/www/test-results目录，可通过卷挂载将结果持久化到本地：

docker run -it --rm -v ./test-results:/var/www/test-results drupalci/webdriver-chromedriver:latest

注意事项

• 确保本地Docker环境资源充足，建议至少分配2GB内存
• 首次运行会下载必要的依赖包，可能需要较长时间
• 不同Drupal版本可能需要特定的镜像标签，请参考官方文档选择合适的版本
• 复杂测试场景建议使用docker-compose管理多容器环境

参考链接

• 官方项目页面
• Drupal CI文档
• Docker Hub镜像库