DrupalCI Docker镜像文档

概述

DrupalCI是Drupal项目的官方持续集成系统，旨在为Drupal开发者提供自动化测试环境。该Docker镜像封装了DrupalCI的核心功能，允许开发者在本地或CI/CD管道中轻松设置和运行Drupal项目的自动化测试。

核心功能和特性

• 自动化运行Drupal单元测试、功能测试和集成测试
• 支持多种Drupal版本和PHP版本的测试环境
• 内置多种测试工具和依赖项
• 可定制的测试配置和环境变量
• 与Drupal.org的测试基础设施兼容
• 支持测试结果报告生成

使用场景和适用范围

• Drupal模块和主题开发者进行本地测试
• CI/CD管道中集成Drupal项目测试
• 贡献者在提交代码前验证兼容性
• 维护者确保项目在不同环境中的稳定性

使用方法和配置说明

基本使用

# 拉取DrupalCI镜像
docker pull drupalci/drupalci-testbot

# 运行基本测试
docker run --rm -v $(pwd):/var/www/html drupalci/drupalci-testbot run-tests.sh

自定义测试配置

创建.drupalci.yml文件来自定义测试配置：

build:
  assessment:
    validate_codebase:
      phplint:
      csslint:
      eslint:
        threshold: 0
    testing:
      run_tests.standard:
        types: 'Simpletest,PHPUnit-Unit,PHPUnit-Kernel,PHPUnit-Functional'
        testgroups: '--all'
        suppress-deprecations: false
        halt-on-fail: false

运行自定义测试配置：

docker run --rm -v $(pwd):/var/www/html drupalci/drupalci-testbot

使用docker-compose

创建docker-compose.yml文件：

version: '3'
services:
  drupalci:
    image: drupalci/drupalci-testbot
    volumes:
      - ./:/var/www/html
    environment:
      - DRUPAL_CORE_BRANCH=9.5.x
      - PHP_VERSION=8.1
      - DB_TYPE=mysql
      - DB_VERSION=5.7

启动测试环境：

docker-compose up

环境变量配置

常用环境变量：

高级配置示例

docker run --rm \
  -v $(pwd):/var/www/html \
  -v $(pwd)/custom.ini:/usr/local/etc/php/conf.d/custom.ini \
  -e DRUPAL_CORE_BRANCH=10.0.x \
  -e PHP_VERSION=8.2 \
  drupalci/drupalci-testbot

注意事项

• 首次运行可能需要较长时间下载依赖项
• 建议为Docker分配足够的系统资源以确保测试性能
• 大型测试套件建议使用卷挂载而非复制文件
• 定期更新镜像以获取最新的测试工具和安全修复

相关资源

• DrupalCI官方文档
• DrupalCI GitHub仓库
• Drupal自动化测试指南