pookmish/drupal8ci

定制化Drupal 8 CI镜像文档

镜像概述

本镜像为juampynr/drupal8ci:latest的定制版本，针对Drupal 8项目的持续集成/持续部署（CI/CD）流程进行优化。保留原镜像对Drupal 8开发环境的基础支持，同时通过定制化配置增强环境适应性，满足特定项目的构建、测试及自动化部署需求。

核心功能与特性

1. 基础环境保留

• 继承juampynr/drupal8ci:latest的核心组件，包括Drupal 8运行时依赖（PHP、数据库客户端、Web服务器等）、测试工具（PHPUnit、Behat等）及CI流程基础工具（Git、Composer、Drush等）。

2. 定制化增强

• 工具版本调整：根据项目需求优化关键工具版本（如PHP扩展、测试框架版本等）。
• 配置预设：内置定制化的CI/CD流程配置（如测试脚本、构建步骤模板），减少项目配置复杂度。
• 环境适应性：支持自定义环境变量注入，适配不同CI平台（Jenkins、GitLab CI、GitHub Actions等）的运行环境。

使用场景

• Drupal 8项目持续集成：自动化执行代码检查、单元测试、功能测试等流程。
• 构建部署流水线：配合CI平台实现Drupal 8项目的自动化构建、打包及部署。
• 开发环境一致性：在团队内部或CI环境中提供统一的Drupal 8开发/测试环境，避免"环境不一致"问题。

使用方法与配置说明

基本使用（Docker Run）

通过挂载项目目录并执行CI任务：

bash
docker run --rm -v $(pwd):/app \
  -e DRUPAL_ENV=test \
  -e DB_HOST=mysql \
  custom-drupal8ci:latest \
  /bin/bash -c "composer install && vendor/bin/phpunit"

• -v $(pwd):/app：将本地Drupal 8项目目录挂载至容器内/app路径。
• 环境变量（示例）：
  • DRUPAL_ENV：指定运行环境（如test、ci），影响配置加载。
  • DB_HOST：数据库服务地址，用于测试环境数据库连接。

Docker Compose配置

适用于多服务依赖场景（如需联动数据库服务）：

yaml
version: '3'
services:
  ci:
    image: custom-drupal8ci:latest
    volumes:
      - ./:/app
    environment:
      - DRUPAL_ENV=ci
      - DB_HOST=db
      - DB_USER=root
      - DB_PASSWORD=secret
    depends_on:
      - db
  db:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=secret
      - MYSQL_DATABASE=drupal_test

执行CI任务：docker-compose run ci vendor/bin/behat

定制化配置

可通过以下方式调整容器行为：

1. 挂载自定义配置文件：如覆盖php.ini、phpunit.xml等，示例：

   bash
   docker run --rm -v $(pwd):/app -v $(pwd)/custom-php.ini:/usr/local/etc/php/php.ini custom-drupal8ci:latest
   

2. 执行自定义脚本：在容器启动时运行项目特定的CI脚本：

   bash
   docker run --rm -v $(pwd):/app custom-drupal8ci:latest /app/scripts/ci-pipeline.sh
   

注意事项

• 本镜像基于juampynr/drupal8ci:latest构建，具体基础组件版本请参考原镜像文档。
• 定制化内容需根据实际项目需求调整，建议通过Dockerfile维护定制逻辑，确保环境可复现。
• 运行时需确保挂载的项目目录权限正确（容器内默认用户可能为www-data或root）。