ppc64le/drupal

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 或 http://主机IP:8080 即可进入 Drupal 初始化配置界面。

数据库配置

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

MySQL 配置

1. 启动 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

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

PostgreSQL 配置

1. 启动 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

2. 在 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）

1. 预初始化主机目录（仅首次执行）：

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

2. 启动容器并挂载目录：

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）

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

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

2. 启动容器并挂载卷：

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 扩展。如需添加，需基于此镜像构建自定义镜像。参考 https://github.com/docker-library/docs/blob/master/php/README.md#how-to-install-more-php-extensions 了解扩展安装方法。

示例 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/*

以任意用户运行

参考 https://hub.docker.com/_/php/%E3%80%82

镜像变体

ppc64le/drupal:<version>

默认镜像，基于 Debian 系统，包含 Apache 和 PHP。适合大多数场景，可直接运行或作为基础镜像构建自定义镜像。标签中的 bookworm、trixie 等为 Debian 发行版代号，建议显式指定以避免基础系统更新导致的兼容性问题。

ppc64le/drupal:<version>-fpm

包含 PHP-FPM（FastCGI 进程管理器），需配合反向代理（如 Nginx、Apache）使用。警告：FastCGI 协议不适合暴露在公网，除非明确了解风险，否则不要使用 -p 选项发布端口。

支持的标签和架构

支持的标签

标签列表过长，完整列表参见 https://github.com/docker-library/docs/tree/master/drupal/README.md#supported-tags-and-respective-dockerfile-links%E3%80%82

支持的架构

• amd64：https://hub.docker.com/r/amd64/drupal/
• arm32v6：https://hub.docker.com/r/arm32v6/drupal/
• arm32v7：https://hub.docker.com/r/arm32v7/drupal/
• arm64v8：https://hub.docker.com/r/arm64v8/drupal/
• i386：https://hub.docker.com/r/i386/drupal/
• ppc64le：https://hub.docker.com/r/ppc64le/drupal/
• riscv64：https://hub.docker.com/r/riscv64/drupal/
• s390x：https://hub.docker.com/r/s390x/drupal/

维护与支持

维护者

https://github.com/docker-library/drupal%EF%BC%88%E9%9D%9E Drupal 社区或 Drupal 安全团队）

获取帮助

• Docker Community Slack
• Server Fault
• Unix & Linux
• Stack Overflow

提交问题

https://github.com/docker-library/drupal/issues?q=

镜像更新信息

• https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fdrupal
• https://github.com/docker-library/official-images/blob/master/library/drupal%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/drupal%EF%BC%89

许可信息

• 软件许可：Drupal 许可信息
• 镜像包含的其他软件（如基础系统组件）可能有不同许可，详细信息参见 https://github.com/docker-library/repo-info/tree/master/repos/drupal%E3%80%82

使用本镜像即表示您同意遵守所有包含软件的许可条款。