wodby/drupal

Drupal 基础容器镜像 (Vanilla Drupal)

1. 镜像概述和主要用途

概述

该镜像为基础版Drupal容器镜像，旨在提供轻量、可配置的Drupal CMS（内容管理系统）运行环境。基于官方Drupal源码或优化运行时构建，包含运行Drupal所需的核心依赖（如PHP及扩展、基础配置），支持快速部署独立Drupal实例或集成至Docker化应用栈。

主要用途

• 快速搭建Drupal开发、测试或生产环境
• 作为Docker化Drupal架构的核心组件，与数据库、Web服务器等服务协同工作
• 集成至CI/CD流程，实现自动化构建、测试与部署
• 简化Drupal学习、演示或原型验证过程

2. 核心功能和特性

• 轻量精简：基于最小化基础镜像构建，降低资源占用
• 版本支持：兼容多版本Drupal（具体版本通过镜像标签指定）
• 即开即用：预配置核心依赖（PHP扩展、权限设置），无需手动安装基础组件
• 灵活配置：通过环境变量自定义Drupal设置、数据库连接及PHP参数
• 生态兼容：无缝集成Docker Compose、Kubernetes等编排工具，支持与MySQL/MariaDB、PostgreSQL、Nginx、Redis等服务联动

3. 使用场景和适用范围

3.1 开发环境

• 本地快速启动Drupal实例，通过卷挂载实现代码实时同步与调试
• 多版本Drupal并行开发（通过不同容器实例或标签隔离）

3.2 测试与CI/CD

• 自动化测试环境：验证模块更新、主题变更或配置修改
• 作为CI/CD流水线节点，支持构建产物部署前的集成测试

3.3 生产环境

• 配合数据库、反向代理（如Nginx）及持久化存储，部署高可用Drupal服务
• 支持水平扩展，通过负载均衡提升并发处理能力

3.4 学习与演示

• 快速启动纯净Drupal环境，学习CMS功能或验证第三方模块
• 临时演示项目效果，无需复杂环境配置

4. 使用方法和配置说明

4.1 前提条件

• Docker Engine 20.10+
• （可选）Docker Compose 2.0+（用于多服务编排）

4.2 快速启动（单容器模式）

通过docker run直接启动（需提前准备数据库服务）：

bash
docker run -d \
  --name drupal-vanilla \
  -p 8080:80 \
  -e DB_HOST=mysql \
  -e DB_USER=drupal_user \
  -e DB_PASSWORD=secure_password \
  -e DB_NAME=drupal_db \
  wodby/drupal:latest

• -p 8080:80：将容器内80端口映射至主机8080端口，通过http://localhost:8080访问
• 环境变量：配置数据库连接信息，需与实际数据库服务参数匹配

4.3 Docker Compose 配置示例

推荐使用Docker Compose编排完整服务栈（含Drupal、数据库），示例docker-compose.yml：

yaml
version: '3.8'

services:
  # Drupal 应用服务
  drupal:
    image: wodby/drupal:latest
    container_name: drupal-app
    restart: unless-stopped
    ports:
      - "8080:80"  # Web访问端口
    environment:
      # 数据库连接配置
      DB_HOST: mysql
      DB_PORT: 3306
      DB_USER: drupal_user
      DB_PASSWORD: ${DB_PASSWORD:-drupal_pass}
      DB_NAME: drupal_db
      # Drupal核心配置
      DRUPAL_VERSION: 10  # 指定Drupal版本（可选）
      AUTO_INSTALL: "true"  # 自动完成Drupal安装（跳过Web向导）
      PHP_MEMORY_LIMIT: "256M"  # PHP内存限制
      # 管理员账户配置（自动安装时生效）
      DRUPAL_ADMIN_USER: admin
      DRUPAL_ADMIN_PASS: ${ADMIN_PASS:-admin_secure_123}
    volumes:
      - ./drupal-data:/var/www/html  # 持久化Drupal代码与数据
    depends_on:
      - mysql

  # MySQL 数据库服务
  mysql:
    image: mysql:8.0
    container_name: drupal-mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${ROOT_PASS:-root_secure_123}
      MYSQL_DATABASE: drupal_db
      MYSQL_USER: drupal_user
      MYSQL_PASSWORD: ${DB_PASSWORD:-drupal_pass}
    volumes:
      - mysql-data:/var/lib/mysql  # 数据库数据持久化

volumes:
  mysql-data:  # 自动创建的数据库数据卷

启动流程：

bash
# （可选）创建环境变量文件存储敏感信息
echo "DB_PASSWORD=custom_db_pass" > .env
echo "ADMIN_PASS=custom_admin_pass" >> .env

# 启动服务栈
docker-compose up -d

# 查看日志确认启动状态
docker-compose logs -f drupal

访问Drupal：通过http://localhost:8080访问，若AUTO_INSTALL=true则直接进入登录页（使用配置的管理员账户）。

4.4 数据持久化

关键挂载目录：

• /var/www/html：Drupal代码、配置及用户上传文件目录，建议挂载至主机目录或命名卷（开发环境用于代码同步，生产环境用于数据持久化）
• /usr/local/etc/php/conf.d/：（可选）自定义PHP配置文件目录，用于覆盖默认PHP.ini参数

5. 配置参数（环境变量）

6. 注意事项

• 数据库依赖：Drupal需外部数据库服务，启动前确保数据库可访问（通过depends_on或健康检查控制启动顺序）。
• 版本兼容性：Drupal版本与PHP、数据库版本需匹配（如Drupal 10要求PHP 8.1+、MySQL 5.7+），具体参考Drupal官方文档。
• 生产环境安全：
  • 禁用默认密码，通过环境变量或Docker Secrets注入敏感信息
  • 启用HTTPS（配合Nginx或Traefik等反向代理）
  • 限制容器权限，避免使用root用户运行
• 性能优化：高负载场景建议添加Redis/Memcached缓存、配置PHP-FPM进程池，并参考https://github.com/wodby/docker4drupal%E5%AE%8C%E6%95%B4%E6%A0%88%E9%85%8D%E7%BD%AE%E3%80%82

7. 相关资源

• 镜像源码：https://github.com/wodby/drupal
• 完整开发栈：https://github.com/wodby/docker4drupal%EF%BC%88%E5%90%ABNginx%E3%80%81PHP-FPM%E3%80%81%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%81%E7%BC%93%E5%AD%98%E7%AD%89%E7%BB%84%E4%BB%B6%EF%BC%89
• 部署指南：Wodby Drupal Stack 服务器部署文档