dcycle/drupal

Drupal+Drush Docker镜像文档

镜像概述和主要用途

本镜像为Drupal开发者和管理员提供集成了Drupal CMS与Drush（Drupal命令行工具）的Docker环境，每周三定期更新以确保组件为最新稳定版本。旨在简化Drupal项目的环境配置，支持从开发到部署的全流程应用，满足不同场景下的Drupal项目需求。

核心功能和特性

• 组件完整性：包含最新稳定版Drupal CMS和Drush工具，开箱即可使用
• 定期更新：每周三自动更新镜像，确保Drupal、Drush及依赖项的安全性和功能更新
• 轻量级设计：基于官方基础镜像优化，减少镜像体积，提升部署和启动速度
• 兼容性：遵循Docker标准规范，兼容Docker Compose、Kubernetes等容器编排工具及CI/CD工作流

使用场景和适用范围

• 本地开发环境：供Drupal开发者快速搭建一致的本地开发环境，避免环境差异问题
• 自动化测试：集成到CI/CD流程中，用于Drupal项目的单元测试、集成测试和功能测试
• 生产部署：适用于中小型Drupal网站的生产环境部署，支持通过环境变量和配置文件自定义设置
• 版本验证：用于测试Drupal版本升级、模块兼容性或迁移方案的临时环境

使用方法和配置说明

基本使用示例

快速启动容器

通过以下命令启动一个基础Drupal环境（默认映射到本地8080端口）：

bash
docker run -d -p 8080:80 --name drupal-dev dcycle/drupal

访问 http://localhost:8080 即可打开Drupal安装界面。

挂载本地项目目录

将本地Drupal项目代码挂载到容器中，实现实时开发：

bash
docker run -d -p 8080:80 \
  -v $(pwd)/my-drupal-project:/var/www/html \
  --name drupal-dev \
  dcycle/drupal

Docker Compose配置示例

创建 docker-compose.yml 文件，配置Drupal与数据库的集成环境：

yaml
version: '3'
services:
  drupal:
    image: dcycle/drupal
    ports:
      - "8080:80"
    volumes:
      - ./my-drupal-project:/var/www/html
    depends_on:
      - db
    environment:
      - DRUPAL_DB_HOST=db
      - DRUPAL_DB_USER=root
      - DRUPAL_DB_PASSWORD=secret
      - DRUPAL_DB_NAME=drupal
  db:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=secret
      - MYSQL_DATABASE=drupal

运行 docker-compose up -d 启动整个环境。

配置参数说明

镜像支持通过环境变量自定义配置，常用参数包括：

• DRUPAL_VERSION：指定Drupal版本（如 9.5，默认使用最新稳定版）
• DRUSH_ALIAS：设置Drush别名，便于命令行操作
• PHP_MEMORY_LIMIT：调整PHP内存限制（如 256M）

完整配置参数及高级用法请参考官方文档：https://github.com/dcycle/docker-drupal