bitnamicharts/drupal

Bitnami Drupal 镜像文档

镜像概述和主要用途

Drupal 是全球最通用的开源内容管理系统之一，可用于构建从个人博客到企业门户网站的各类网站。Bitnami 提供的 Drupal 镜像预配置了 Ctools 和 Views 模块、Drush 命令行工具以及 Let's Encrypt 自动配置支持，简化了部署和管理流程。

Drupal 官方概述

商标说明：本软件包由 Bitnami 打包，相关商标归各自公司所有，使用此类商标不意味着任何关联或背书。

核心功能和特性

Drupal 核心功能

• 模块化架构：支持数千个社区模块，可扩展功能如电子商务、社交网络、工作流等
• 内容管理：灵活的内容类型定义、版本控制、多格式内容支持
• 多语言支持：内置国际化功能，支持超过 100 种语言
• 用户权限管理：细粒度的角色和权限控制系统，支持复杂访问策略
• 主题系统：可定制的前端主题，支持响应式设计

Bitnami 镜像特性

• 预配置环境：包含 Ctools、Views 等常用模块，开箱即用
• 安全加固：遵循最佳安全实践，定期更新以修复漏洞
• Drush 集成：内置 Drupal 命令行管理工具，支持自动化操作
• Let's Encrypt 支持：自动配置 SSL/TLS 证书，简化 HTTPS 部署
• 持久化存储：支持 Kubernetes PV/PVC 及 Docker 卷挂载，确保数据持久化

使用场景和适用范围

适用场景

• 企业门户网站：构建公司官网、内部协作平台
• 内容发布平台：博客、新闻网站、在线杂志
• 电子商务网站：通过 Commerce 模块搭建在线商店
• 社区论坛：构建用户互动社区、问答平台
• ***/教育网站：满足合规性要求的公共信息发布平台

适用环境

• 开发环境：快速搭建本地开发实例，支持代码调试和模块测试
• 测试环境：验证新功能、主题或模块兼容性
• 生产环境：配合 Bitnami Secure Images 提供安全加固的生产部署（需商业许可）

详细使用方法和配置说明

快速部署（TL;DR）

Docker 快速启动

bash
docker run --name drupal -p 8080:8080 -p 8443:8443 \
  -e DRUPAL_USERNAME=admin \
  -e DRUPAL_PASSWORD=password \
  -e DRUPAL_EMAIL=admin@example.com \
  -e MARIADB_HOST=mariadb \
  -e MARIADB_PORT_NUMBER=3306 \
  -e MARIADB_USER=bn_drupal \
  -e MARIADB_PASSWORD=dbpassword \
  -e MARIADB_DATABASE=bitnami_drupal \
  bitnami/drupal:latest

Docker Compose 配置

yaml
version: '3'

services:
  mariadb:
    image: bitnami/mariadb:latest
    environment:
      - MARIADB_ROOT_PASSWORD=rootpassword
      - MARIADB_USER=bn_drupal
      - MARIADB_PASSWORD=dbpassword
      - MARIADB_DATABASE=bitnami_drupal
    volumes:
      - mariadb_data:/bitnami/mariadb

  drupal:
    image: bitnami/drupal:latest
    ports:
      - 8080:8080
      - 8443:8443
    environment:
      - DRUPAL_USERNAME=admin
      - DRUPAL_PASSWORD=password
      - DRUPAL_EMAIL=admin@example.com
      - MARIADB_HOST=mariadb
      - MARIADB_PORT_NUMBER=3306
      - MARIADB_USER=bn_drupal
      - MARIADB_PASSWORD=dbpassword
      - MARIADB_DATABASE=bitnami_drupal
    volumes:
      - drupal_data:/bitnami/drupal
    depends_on:
      - mariadb

volumes:
  mariadb_data:
  drupal_data:

Helm Chart 部署（Kubernetes）

bash
helm install my-release oci://registry-1.docker.io/bitnamicharts/drupal

前提条件

Docker 环境

• Docker 19.03+
• Docker Compose 2.0+（如需使用 Compose）

Kubernetes 环境（Helm 部署）

• Kubernetes 1.23+
• Helm 3.8.0+
• 支持 PV 供应的基础设施
• ReadWriteMany 卷（用于部署扩展）

安装与配置

Docker 部署

基础配置

1. 启动 MariaDB 数据库（独立部署）：

bash
docker run --name mariadb -e MARIADB_ROOT_PASSWORD=rootpassword \
  -e MARIADB_USER=bn_drupal -e MARIADB_PASSWORD=dbpassword \
  -e MARIADB_DATABASE=bitnami_drupal -d bitnami/mariadb:latest

2. 启动 Drupal 并连接数据库：

bash
docker run --name drupal --link mariadb:mariadb -p 8080:8080 -p 8443:8443 \
  -e DRUPAL_USERNAME=admin -e DRUPAL_PASSWORD=password \
  -e DRUPAL_EMAIL=admin@example.com \
  -e MARIADB_HOST=mariadb -e MARIADB_PORT_NUMBER=3306 \
  -e MARIADB_USER=bn_drupal -e MARIADB_PASSWORD=dbpassword \
  -e MARIADB_DATABASE=bitnami_drupal \
  -d bitnami/drupal:latest

3. 访问应用：打开浏览器访问 http://localhost:8080 或 https://localhost:8443

持久化存储配置

通过 Docker 卷挂载持久化 Drupal 数据：

bash
docker run --name drupal --link mariadb:mariadb -p 8080:8080 -p 8443:8443 \
  -e DRUPAL_USERNAME=admin -e DRUPAL_PASSWORD=password \
  -v /path/to/drupal/data:/bitnami/drupal \
  -d bitnami/drupal:latest

Helm Chart 部署（Kubernetes）

安装 Chart

bash
helm install my-release oci://registry-1.docker.io/bitnamicharts/drupal \
  --set drupalUsername=admin \
  --set drupalPassword=password \
  --set mariadb.auth.rootPassword=rootpassword \
  --set mariadb.auth.password=dbpassword

自定义配置

通过 values.yaml 文件自定义配置：

yaml
drupal:
  username: admin
  password: securepassword
  email: admin@example.com
mariadb:
  auth:
    rootPassword: strongrootpass
    password: strongdbpass
persistence:
  size: 10Gi
service:
  type: LoadBalancer

应用自定义配置：

bash
helm install my-release oci://registry-1.docker.io/bitnamicharts/drupal -f values.yaml

持久化配置

Drupal 数据和配置存储在容器内 /bitnami/drupal 路径，支持以下持久化方式：

Docker 环境

• 卷挂载：使用 -v /host/path:/bitnami/drupal 挂载主机目录
• 命名卷：创建命名卷 docker volume create drupal_data，并通过 -v drupal_data:/bitnami/drupal 挂载

Kubernetes 环境

• PVC 自动创建：默认启用，可通过 persistence.size 指定存储大小
• 使用现有 PVC：

bash
helm install my-release --set persistence.existingClaim=my-pvc oci://registry-1.docker.io/bitnamicharts/drupal

• HostPath 挂载（仅开发环境）：

bash
helm install my-release --set persistence.hostPath=/path/on/host oci://registry-1.docker.io/bitnamicharts/drupal

升级与维护

Docker 容器升级

1. 停止并备份当前容器：

bash
docker stop drupal
docker rename drupal drupal-backup

2. 拉取最新镜像并启动新容器：

bash
docker pull bitnami/drupal:latest
docker run --name drupal --link mariadb:mariadb -p 8080:8080 -p 8443:8443 \
  -e DRUPAL_USERNAME=admin -e DRUPAL_PASSWORD=password \
  -v drupal_data:/bitnami/drupal -d bitnami/drupal:latest

Helm Chart 升级

bash
helm upgrade my-release oci://registry-1.docker.io/bitnamicharts/drupal

⚠️ 重要通知：Bitnami 镜像仓库变更

自 2025 年 8 月 28 日起，Bitnami 将升级其公共镜像仓库，推出 Bitnami Secure Images 计划，主要变更包括：

核心变更

• 安全加固镜像：首次向社区用户开放安全优化版本的容器镜像
• 非加固镜像 deprecation：逐步停止对 Debian 基础的非加固镜像免费支持，公共仓库将仅保留少量加固镜像（仅 latest 标签，用于开发目的）
• 镜像迁移：现有所有镜像（含历史版本标签，如 2.50.0、10.6）将在两周内从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy 仓库，且不再更新
• 生产环境建议：生产环境需使用 Bitnami Secure Images（商业许可），包含加固容器、更小***面、CVE 透明度（VEX/KEV）、SBOM 及企业支持

影响与建议

• 开发环境：继续使用 docker.io/bitnami 的 latest 标签（加固镜像）
• 生产环境：迁移至 Bitnami Secure Images（需联系 Broadcom 获取许可）
• 历史版本：如需旧版本，需从 docker.io/bitnamilegacy 拉取，且自行承担安全风险

配置参数

全局参数

通用参数

Drupal 核心参数

完整参数列表

完整参数及详细说明请参考 https://github.com/bitnami/charts/blob/main/bitnami/drupal/README.md