smartbeespl/drupal-base Docker 镜像 - 轩辕镜像

Drupal基础镜像

镜像概述和主要用途

Drupal基础镜像是一个预配置的Docker镜像，基于PHP 8.3，专为Drupal应用设计。主要用于两种场景：作为独立服务直接部署Drupal应用，或作为基础镜像构建包含自定义代码、依赖和资产的Drupal项目。镜像提供灵活的配置选项，支持用户ID（UID）和组ID（GID）自定义，确保文件权限兼容。

核心功能和特性

• 基于PHP 8.3，满足Drupal运行环境要求
• 支持两种使用模式：独立服务运行和基础镜像扩展
• 可通过构建参数（UID、GID）自定义文件所有权，解决权限问题
• 集成Composer和Yarn，支持依赖安装和前端资源构建（作为基础镜像时）
• 轻量级设计，适用于开发和生产环境

使用场景和适用范围

• 独立部署：快速启动Drupal服务，适用于简单应用或测试环境
• 自定义构建：作为基础镜像集成项目代码、依赖和资产，适用于生产环境的自定义Drupal项目

详细使用方法和配置说明

1. 作为独立服务使用

通过docker-compose直接运行镜像，将本地Drupal代码挂载到容器中。

配置示例（compose.yml）

yaml
# compose.yml
services:
  drupal:
    image: smartbeespl/drupal-base:php8.3
    restart: unless-stopped
    volumes:
      - .:/opt/drupal

说明：

• volumes：将当前目录（包含Drupal代码）挂载到容器内/opt/drupal目录
• restart: unless-stopped：容器退出后自动重启（除非手动停止）

2. 作为基础镜像使用

通过Dockerfile构建自定义镜像，集成项目代码、依赖和资产，再通过docker-compose部署。

步骤1：创建Dockerfile

Dockerfile
# Dockerfile
FROM smartbeespl/drupal-base:php8.3

ARG UID=1000
ARG GID=1000

# 复制项目源代码（指定文件所有权为UID:GID）
COPY --chown=$UID:$GID . .

RUN set -xe; \
  # 安装Composer依赖（排除开发依赖）
  composer install --no-cache --no-dev; \
  # 安装Yarn依赖并构建前端资产，完成后清理node_modules
  yarn; yarn build; rm -rf node_modules

步骤2：配置docker-compose.yml

yaml
# compose.yml
services:
  drupal:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        UID: ${UID:-1000}  # 从环境变量获取UID，默认1000
        GID: ${GID:-1000}  # 从环境变量获取GID，默认1000
    restart: unless-stopped
    volumes:
      # 持久化Drupal上传文件
      - ./data/drupal/files:/opt/drupal/web/sites/default/files
      # 持久化Drupal私有文件
      - ./data/drupal/private_files:/opt/drupal/private_files

参数说明：

• UID：构建参数，指定文件所有者用户ID，默认1000
• GID：构建参数，指定文件所有者组ID，默认1000
• 挂载卷./data/drupal/files和./data/drupal/private_files用于持久化数据，避免容器重启后文件丢失