alchatti/drupal-devcontainer

Drupal开发容器

!https://img.shields.io/github/last-commit/alchatti/drupal-devcontainer-image?style=for-the-badge !https://img.shields.io/docker/pulls/alchatti/drupal-devcontainer?style=for-the-badge

!https://img.shields.io/badge/Docker-2CA5E0?style=for-the-badge&logo=docker&logoColor=white !https://img.shields.io/badge/PHP-777BB4?style=for-the-badge&logo=php&logoColor=white !https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white !https://img.shields.io/badge/Drupal-0678BE?style=for-the-badge&logo=drupal&logoColor=white !https://img.shields.io/badge/Ubuntu-E95420?style=for-the-badge&logo=ubuntu&logoColor=white !https://img.shields.io/badge/apple%20silicon-333333?style=for-the-badge&logo=apple&logoColor=white !https://img.shields.io/badge/VSCode-0078D4?style=for-the-badge&logo=visual%20studio%20code&logoColor=white

!https://badgen.net/docker/stars/alchatti/drupal-devcontainer?icon=docker&label=stars !https://img.shields.io/docker/image-size/alchatti/drupal-devcontainer/7.4?label=7.4&logo=PHP !https://img.shields.io/docker/image-size/alchatti/drupal-devcontainer/8.1?label=8.1&logo=PHP !https://img.shields.io/docker/image-size/alchatti/drupal-devcontainer/8.1?label=8.2&logo=PHP

https://github.com/alchatti/drupal-devcontainer-image/actions/workflows/build-and-push.yml/badge.svg?branch=main](https://github.com/alchatti/drupal-devcontainer-image/actions/workflows/build-and-push.yml) https://github.com/alchatti/drupal-devcontainer-image/actions/workflows/update-container-description.yml/badge.svg](https://github.com/alchatti/drupal-devcontainer-image/actions/workflows/update-container-description.yml)

基于Microsoft PHP devcontainer镜像构建的Drupal开发容器。

使用说明

https://code.visualstudio.com/docs/remote/containers%E9%95%9C%E5%83%8F%E6%98%AF%E7%94%A8%E4%BA%8E%E5%9C%A8%E5%AE%B9%E5%99%A8%E5%86%85%E8%BF%9B%E8%A1%8C%E5%BC%80%E5%8F%91%E7%9A%84%E9%95%9C%E5%83%8F%EF%BC%8C%E9%A2%84%E8%A3%85%E4%BA%86%E5%BC%80%E5%8F%91Drupal%E5%92%8CNode.js%E9%A1%B9%E7%9B%AE%E6%89%80%E9%9C%80%E7%9A%84%E5%B7%A5%E5%85%B7%E3%80%82

该镜像可独立使用，推荐配合https://github.com/alchatti/drupal-devcontainer%E4%B8%8EVS Code使用，以获得交互式开发体验，并自动安装必要的扩展。

基础Drupal项目示例可参考https://github.com/alchatti/drupal-devcontainer-sample-project%E3%80%82

容器的开发功能针对vscode用户配置，这是Microsoft基础镜像提供的非root用户。

Apache服务器将通过启动脚本中的apache2ctl start命令启动

Xdebug端口为9003，这是https://xdebug.org/docs/all_settings#client_port%E3%80%82

快速开始：独立Drupal站点（用于测试和演示）

Drupal 10可使用SQLite安装，无需额外数据库容器。

为获得最佳开发体验，请以vscode用户启动容器。主机名drupal-dev可替换为其他名称。

1. 以交互模式启动容器（退出后自动删除），Docker将自动创建卷drupal-dev-html以持久化站点安装：

bash
docker run --rm -it \
-h "drupal-dev" \
-u "vscode" \
-p 80:80 \
-v "drupal-dev-html:/var/www/html" \
alchatti/drupal-devcontainer:8.1 fish

2. 容器初始化完成后，访问http://localhost可查看PHP信息页面。

3. 可使用init.sh命令创建新的Drupal 10站点。选择SQLite作为数据库选项可实现独立镜像运行。此脚本基于Acquia配置，也可手动设置Drupal。

bash
init.sh

4. Drupal安装完成后，访问http://localhost开始配置Drupal。

5. 演示场景下，选择“Demo: Umami Food Magazine (Experimental)”作为安装配置文件。

6. 数据库选择SQLite，数据库文件使用默认路径sites/default/files/.ht.sqlite。

7. 配置站点，设置admin用户名和密码。

8. 访问http://localhost即可查看Drupal站点。

9. 退出容器并停止服务：

bash
exit

• 删除创建的卷以重新开始：

bash
docker volume rm drupal-dev-html

其他使用选项和参数

• 通过环境变量POSH_THEME_ENVIRONMENT更改shell为zsh并设置主题为'blue-owl'，更多主题选项参见https://ohmyposh.dev/docs/themes%EF%BC%9A

bash
docker run --rm -it \
-e POSH_THEME_ENVIRONMENT='blue-owl' \
-h "drupal-dev" \
-u "vscode" \
-p 80:80 \
-v "drupal-dev-html:/var/www/html" \
alchatti/drupal-devcontainer:8.1 zsh

标签

特定版本构建的标签格式为$php-$datetime。

可用标签：

• 8.2：包含PHP 8.2、最新Node.js和构建时的最新Composer。
• 8.1：包含PHP 8.1、最新Node.js和构建时的最新Composer。

旧版/已弃用标签：

• 7.4：包含PHP 7.4、最新Node.js和构建时的最新Composer。（最后构建时间：2023年12月1日）

也可使用时间戳标签定位特定构建版本，详见https://hub.docker.com/r/alchatti/drupal-devcontainer/tags%E3%80%82

镜像信息

该镜像针对PHP 8.1和8.2的最新版本构建，包含最新Node.js。

脚本

bash
# 以JSON格式打印镜像包版本/标签信息
about | jq
# 使用drush创建带时间戳的数据库转储，并存储到/var/www/html/dump目录
dump.sh
# 使用acli下载最新的Acquia云数据库备份
acli-dump.sh

预装软件包

基础镜像已包含Zsh、https://httpd.apache.org/%E3%80%81https://xdebug.org/%E3%80%81https://getcomposer.org/%EF%BC%8C%E9%A2%9D%E5%A4%96%E9%A2%84%E8%A3%85%E4%BB%A5%E4%B8%8B%E8%BD%AF%E4%BB%B6%E5%8C%85%EF%BC%9A

• Drupal开发工具

  • https://github.com/drush-ops/drush-launcher
  • Drush 8（全局备用，适用于Drupal 7）
  • https://www.drupal.org/project/coder

• Acquia工具

  • Acquia CLI（需PHP 8）
  • https://github.com/acquia/blt-launcher/

• 前端开发工具

  • https://nodejs.org

• 终端增强工具：

  • https://github.com/zsh-users/zsh-autosuggestions
  • https://github.com/zsh-users/zsh-syntax-highlighting
  • fish
  • https://ohmyposh.dev/%EF%BC%88%E9%80%82%E7%94%A8%E4%BA%8EZsh%E5%92%8CFish%EF%BC%89

• Git增强工具：

  • https://github.com/arzzen/git-quick-stats%EF%BC%9A%E4%B8%80%E7%A7%8D%E7%AE%80%E5%8D%95%E9%AB%98%E6%95%88%E7%9A%84Git%E4%BB%93%E5%BA%93%E7%BB%9F%E8%AE%A1%E4%BF%A1%E6%81%AF%E6%9F%A5%E7%9C%8B%E5%B7%A5%E5%85%B7

环境变量

以下环境变量用于自定义配置：

bash
# Apache环境变量默认值
ENV APACHE_SERVER_NAME "localhost"
ENV APACHE_DOCUMENT_ROOT "docroot"
ENV WORKSPACE_ROOT "/var/www/html"
# Oh My Posh默认主题环境变量
ENV POSH_THEME_ENVIRONMENT "ys"

CI构建与标签

构建流程通过GitHub Actions工作流自动化，包含两个脚本：

• build.sh：根据PHP、Node、Sass版本构建镜像，参数如下：

  • -p：PHP版本（如7或8）
  • -n：Node.js版本，node表示最新版，--lts表示LTS版本

• test.sh：加载最新本地构建镜像

工作流按计划执行，也可在推送到main分支时触发，或通过GitHub手动触发。

参考链接

• Docker仓库：https://hub.docker.com/r/alchatti/drupal-devcontainer
• 镜像问题、详情和源码：https://github.com/alchatti/drupal-devcontainer-image

更新日志

2024年1月

• 功能：基础镜像更新至Debian 12（Bookworm）
• 功能：fish通过仓库安装
• 功能：GitHub Actions更新如下：
  • actions/checkout@v2→4
  • docker/setup-qemu-action@v2→3
  • docker/setup-buildx-action@v2.0.0→3
  • docker/build-push-action@v3→5
• CI：切换到peter-evans/dockerhub-description@v3（持续维护版本）
• 修复：在apache2.conf中通过PassEnv传递APACHE_DOCUMENT_ROOT和WORKSPACE_ROOT，以在/etc/apache2/sites-available/*.conf中生效

2023年12月

• 功能：添加git-quick-stats
• 功能：fish更新至3.6.4-1
• 功能：about脚本可打印基础镜像OS版本
• 功能：停止支持PHP 7.4版本

2023年1月

• 功能：支持PHP 8.1，弃用PHP 8.0
• 功能：支持Apple Silicon arm64架构（PHP 8.1和7.4）
• 功能：支持Drupal 10，更新安装脚本
• 功能：移除已弃用的Drupal Console
• 功能：更新GitHub Action工作流以支持多架构、标签和镜像推送
• 修复：fish与nvm的兼容性问题