Drupal Docker 镜像文档

镜像概述和主要用途

Drupal 是一个开源内容管理平台，用于构建和管理数百万网站和应用程序。它基于 PHP 开发，遵循 GNU 通用公共许可证分发，适用于从个人博客到企业、***网站（如 ***.gov 和 ***）的各种场景，同时也支持知识管理和业务协作。

核心功能和特性

开源免费：基于 GNU GPL 许可证，可自由使用和修改
灵活的内容管理：支持多种内容类型和自定义字段
模块化架构：通过模块（Modules）扩展功能，通过主题（Themes）定制界面
多数据库支持：兼容 MySQL、PostgreSQL、SQLite 等主流数据库
多架构支持：提供多种硬件架构的镜像，包括 ppc64le、amd64、arm 系列等
可扩展性：支持复杂工作流、多语言和访问控制

使用场景和适用范围

个人博客和小型网站
企业官网和品牌展示平台
***和公共机构网站
知识管理系统
在线社区和协作平台
电子商务网站（通过扩展模块实现）

详细使用方法和配置说明

基本使用

启动 Drupal 实例的基本命令：

console
$ docker run --name some-drupal -d ppc64le/drupal

如需从主机访问容器服务，可进行端口映射：

console
$ docker run --name some-drupal -p 8080:80 -d ppc64le/drupal

通过浏览器访问 http://localhost:8080 或 [***] 即可进入 Drupal 初始化配置界面。

数据库配置

Drupal 支持多种数据库，推荐使用 Docker 网络连接数据库容器。首次访问时需在配置向导中完成数据库设置。

MySQL 配置

启动 MySQL 容器：

console
$ docker run -d --name some-mysql --network some-network \
    -e MYSQL_DATABASE=drupal \
    -e MYSQL_USER=user \
    -e MYSQL_PASSWORD=password \
    -e MYSQL_ROOT_PASSWORD=password \
    mysql:5.7

在 Drupal 数据库配置步骤中输入：
- 数据库类型：MySQL
- 数据库名称：drupal（对应 MYSQL_DATABASE）
- 数据库用户名：user（对应 MYSQL_USER）
- 数据库密码：password（对应 MYSQL_PASSWORD）
- 高级选项 > 数据库主机：some-mysql（容器名称，需在同一网络）

PostgreSQL 配置

启动 PostgreSQL 容器：

console
$ docker run -d --name some-postgres --network some-network \
    -e POSTGRES_DB=drupal \
    -e POSTGRES_USER=user \
    -e POSTGRES_PASSWORD=pass \
    postgres:11

在 Drupal 数据库配置步骤中输入：
- 数据库类型：PostgreSQL
- 数据库名称：drupal（对应 POSTGRES_DB）
- 数据库用户名：user（对应 POSTGRES_USER）
- 数据库密码：pass（对应 POSTGRES_PASSWORD）
- 高级选项 > 数据库主机：some-postgres（容器名称，需在同一网络）

数据卷管理

默认情况下，镜像未定义卷。推荐将以下目录挂载为卷以持久化数据：/var/www/html/modules、/var/www/html/profiles、/var/www/html/themes 和 /var/www/html/sites。

绑定挂载（Bind Mounts）

console
$ docker run --rm ppc64le/drupal tar -cC /var/www/html/sites . | tar -xC /path/on/host/sites

console
$ docker run --name some-drupal --network some-network -d \
    -v /path/on/host/modules:/var/www/html/modules \
    -v /path/on/host/profiles:/var/www/html/profiles \
    -v /path/on/host/sites:/var/www/html/sites \
    -v /path/on/host/themes:/var/www/html/themes \
    ppc64le/drupal

Docker 卷（Volumes）

创建卷并初始化（仅首次执行）：

console
$ docker volume create drupal-sites
$ docker run --rm -v drupal-sites:/temporary/sites ppc64le/drupal cp -aRT /var/www/html/sites /temporary/sites

启动容器并挂载卷：

console
$ docker run --name some-drupal --network some-network -d \
    -v drupal-modules:/var/www/html/modules \
    -v drupal-profiles:/var/www/html/profiles \
    -v drupal-sites:/var/www/html/sites \
    -v drupal-themes:/var/www/html/themes \
    ppc64le/drupal

使用 Docker Compose

以下是使用 PostgreSQL 的 compose.yaml 示例：

yaml
# Drupal with PostgreSQL
# 访问地址: "http://localhost:8080"
# 初始化配置时数据库设置：
# - 数据库类型: PostgreSQL
# - 数据库名称: postgres
# - 数据库用户名: postgres
# - 数据库密码: example
# - 高级选项 > 数据库主机: postgres

services:
  drupal:
    image: ppc64le/drupal:10-apache
    ports:
      - 8080:80
    volumes:
      - /var/www/html/modules
      - /var/www/html/profiles
      - /var/www/html/themes
      - /var/www/html/sites  # 自动初始化镜像中的sites内容
    restart: always

  postgres:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: example
    restart: always

启动服务：

console
$ docker compose up -d

添加额外 PHP 扩展或库

默认镜像不包含额外 PHP 扩展。如需添加，需基于此镜像构建自定义镜像。参考 php 镜像文档了解扩展安装方法。

示例 Dockerfile（安装 ldap 扩展）：

dockerfile
FROM ppc64le/drupal:10
RUN set -eux; \
    apt-get update; \
    apt-get install -y --no-install-recommends libldap2-dev; \
    docker-php-ext-configure ldap --with-libdir=lib/ppc64le-linux-gnu/; \
    docker-php-ext-install ldap; \
    apt-get clean; \
    rm -rf /var/lib/apt/lists/*