islandora/drupal

Drupal Docker镜像文档

一、镜像概述

本镜像为Drupal的基础Docker镜像，基于https://github.com/Islandora-DevOps/isle-buildkit/tree/main/drupal%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%E3%80%82%E4%BD%9C%E4%B8%BADrupal%E5%BA%94%E7%94%A8%E7%9A%84%E5%BA%95%E5%B1%82%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%EF%BC%8C%E9%95%9C%E5%83%8F%E6%9C%AC%E8%BA%AB%E4%B8%8D%E9%A2%84%E8%A3%85Drupal%E6%A0%B8%E5%BF%83%E4%BB%A3%E7%A0%81%EF%BC%8C%E9%9C%80%E7%94%B1%E7%94%A8%E6%88%B7%E6%8F%90%E4%BE%9B%E8%87%AA%E5%AE%9A%E4%B9%89Composer%E6%96%87%E4%BB%B6%E3%80%82%E9%95%9C%E5%83%8F%E5%86%85%E7%BD%AE%E5%90%AF%E5%8A%A8%E8%84%9A%E6%9C%AC%EF%BC%8C%E6%94%AF%E6%8C%81%E5%9C%A8%E9%A6%96%E6%AC%A1%E8%BF%90%E8%A1%8C%E6%97%B6%E8%87%AA%E5%8A%A8%E5%AE%8C%E6%88%90Drupal%E7%9A%84%E5%AE%89%E8%A3%85%E9%85%8D%E7%BD%AE%E3%80%82

二、核心功能与特性

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

三、使用场景

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

四、依赖项

• 基础镜像：需依赖islandora/nginx镜像提供Web服务，具体配置（如卷挂载、端口映射）请参考https://github.com/Islandora-DevOps/isle-buildkit/tree/main/nginx%E3%80%82
• 数据库：需外部数据库服务（如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网络配置）。