Drupal Docker镜像文档

一、镜像概述

本镜像为Drupal的基础Docker镜像，基于Islandora-DevOps/isle-buildkit drupal项目构建。作为Drupal应用的底层运行环境，镜像本身不预装Drupal核心代码，需由用户提供自定义Composer文件。镜像内置启动脚本，支持在首次运行时自动完成Drupal的安装配置。

二、核心功能与特性

• 基础环境支持：提供Drupal运行所需的底层依赖（PHP、扩展等），无需手动配置运行环境。
• 自动安装机制：通过启动脚本实现首次运行时的Drupal自动安装，支持指定安装配置文件。
• 多站点部署：支持通过环境变量定义多个独立Drupal站点，满足多域名/多应用场景。
• 灵活配置：通过环境变量自定义数据库连接、站点信息、管理员账号等核心参数。
• 反向代理兼容：支持配置反向代理IP，适配Traefik等网关服务。
• 数据库兼容性：兼容多种数据库后端（依赖基础镜像配置），支持自定义数据库驱动及连接参数。

三、使用场景

• Drupal项目基础镜像：适用于需要自定义Composer依赖的Drupal应用，作为底层运行容器。
• 单站点部署：快速搭建独立Drupal站点，支持标准或自定义安装配置文件。
• 多站点部署：通过环境变量定义多个子站点，实现多域名/多应用共享底层环境。
• 开发与生产环境：支持开发、测试及生产环境（生产环境需自定义密码等敏感配置）。

四、依赖项

• 基础镜像：需依赖islandora/nginx镜像提供Web服务，具体配置（如卷挂载、端口映射）请参考Nginx镜像文档。
• 数据库：需外部数据库服务（如MySQL、PostgreSQL），支持通过环境变量配置连接参数。

五、端口说明

六、环境变量配置

6.1 网络设置

6.2 数据库设置

Drupal支持多种数据库后端，默认连接配置继承自基础镜像。以下变量用于覆盖或补充数据库连接参数：

6.3 默认站点配置

用于配置默认Drupal站点（单站点模式下唯一站点，多站点模式下主站点）：

6.4 多站点配置

通过DRUPAL_SITE_{SITE}_*格式的环境变量定义额外站点，其中{SITE}为自定义站点标识（如BLOG、FORUM）。仅需定义DRUPAL_SITE_{SITE}_NAME即可创建站点，其他参数可选（默认值如下表）：

七、部署示例

7.1 Docker Run 单站点部署

bash
docker run -d \
  --name drupal-site \
  -p 80:80 \
  --link nginx:nginx \  # 链接nginx容器
  --link mysql:db \      # 链接数据库容器（假设数据库容器名为mysql）
  -e DRUPAL_DEFAULT_ACCOUNT_PASSWORD="SecurePassword123" \  # 自定义管理员密码
  -e DRUPAL_DEFAULT_DB_PASSWORD="DBPassword456" \           # 自定义数据库密码
  -e DB_HOST="db" \                                          # 数据库主机（链接的mysql容器名）
  -e DB_USER="root" \                                        # 数据库root用户
  -e DB_ROOT_PASSWORD="RootPassword789" \                     # 数据库root密码
  islandora/drupal

7.2 Docker Compose 多站点部署

yaml
version: '3.8'

services:
  nginx:
    image: islandora/nginx
    ports:
      - "80:80"
    volumes:
      - nginx-conf:/etc/nginx/conf.d
    depends_on:
      - drupal

  drupal:
    image: islandora/drupal
    environment:
      # 默认站点配置
      DRUPAL_DEFAULT_NAME: "main-site"
      DRUPAL_DEFAULT_ACCOUNT_PASSWORD: "MainSitePass123"
      DRUPAL_DEFAULT_DB_PASSWORD: "MainDBPass456"
      # 多站点配置（示例：博客站点）
      DRUPAL_SITE_BLOG_NAME: "blog-site"
      DRUPAL_SITE_BLOG_ACCOUNT_PASSWORD: "BlogPass789"
      DRUPAL_SITE_BLOG_DB_PASSWORD: "BlogDBPass012"
      # 数据库连接基础参数（供所有站点共享）
      DB_HOST: "mysql"
      DB_USER: "root"
      DB_ROOT_PASSWORD: "RootPass345"
    depends_on:
      - mysql

  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: "RootPass345"  # 需与DRUPAL侧DB_ROOT_PASSWORD一致
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  nginx-conf:
  mysql-data:

注意：

• 生产环境中必须替换所有默认密码（如password）为强密码。
• 多站点部署时，需确保Nginx配置正确路由不同站点域名至对应子目录。
• 数据库服务需提前部署，且网络需与Drupal容器互通（通过--link或Docker网络配置）。