chronosorganization/drupal8ci

Drupal 8 CI 镜像 (Chronos项目专用)

镜像概述和主要用途

该镜像为Chronos项目定制，基于Drupal 8构建，专门用于支持持续集成(CI)流程。通过提供标准化的开发和测试环境，确保Chronos项目在自动化构建、代码质量检查、单元测试及集成测试等CI环节中高效执行，减少环境差异导致的问题，提升开发协作效率。

核心功能和特性

• Drupal 8环境预置：预装Drupal 8核心依赖组件、PHP扩展及开发工具链，满足基础运行和测试需求
• CI流程兼容性：支持主流CI/CD平台（Jenkins、GitHub Actions、GitLab CI等）的自动化任务调度
• 测试框架集成：内置PHPUnit、Behat等Drupal常用测试工具，支持自动化测试执行
• 环境一致性：标准化配置消除"本地可运行，CI失败"的环境差异问题
• 轻量级优化：基于精简基础镜像构建，减少资源占用，加快CI流程启动速度

使用场景和适用范围

适用对象

Chronos项目开发团队、DevOps工程师、QA测试人员

典型使用场景

• Chronos项目的Drupal 8模块/主题自动化构建流程
• 代码质量检查（如PHP CodeSniffer代码规范检查、PHPStan静态分析）
• 单元测试、功能测试及集成测试的自动化执行
• CI/CD pipeline中的环境部署验证和版本发布前验证

使用方法和配置说明

基本使用（Docker Run）

bash
docker run --rm -v $(pwd):/app chronos-drupal8-ci:latest [ci-task-command]

参数说明：

• --rm：容器退出后自动清理
• -v $(pwd):/app：挂载本地项目目录到容器内/app路径，供CI流程访问代码
• [ci-task-command]：CI任务具体命令（如依赖安装、测试执行等）

示例：执行代码检查和单元测试

bash
docker run --rm -v $(pwd):/app chronos-drupal8-ci:latest \
  sh -c "composer install && vendor/bin/phpcs --standard=Drupal ./modules/custom && vendor/bin/phpunit ./tests"

环境变量配置

通过环境变量可自定义CI行为，常用配置如下：

示例：指定MySQL数据库并运行功能测试

bash
docker run --rm -v $(pwd):/app \
  -e DRUPAL_DB_URL="mysql://user:password@mysql-host:3306/chronos_ci" \
  -e DRUPAL_TEST_SUITE="functional" \
  chronos-drupal8-ci:latest \
  sh -c "composer install && vendor/bin/behat"

Docker Compose 配置示例

如需关联数据库等依赖服务，可使用docker-compose.yml：

yaml
version: '3.8'
services:
  ci:
    image: chronos-drupal8-ci:latest
    volumes:
      - ./:/app
    environment:
      - DRUPAL_DB_URL=mysql://ci_user:ci_pass@db:3306/chronos_ci
      - PHP_MEMORY_LIMIT=1G
    depends_on:
      - db

  db:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=root_pass
      - MYSQL_DATABASE=chronos_ci
      - MYSQL_USER=ci_user
      - MYSQL_PASSWORD=ci_pass
    ports:
      - "3306:3306"

执行CI任务：

bash
docker-compose run ci sh -c "composer install && vendor/bin/phpunit"

注意事项

• 本地项目目录权限需确保容器可读写（可通过-u $(id -u):$(id -g)参数指定用户ID映射）
• 数据库服务需提前启动（使用depends_on或手动启动）
• 复杂CI流程建议通过Shell脚本封装任务命令，挂载到容器内执行（如-v ./ci-scripts:/scripts && sh /scripts/run-ci.sh）