drydockcloud/drupal-acquia-mysql

drupal-acquia

镜像概述和主要用途

drupal-acquia是Acquia托管环境的Docker复制品，旨在通过匹配Acquia生产环境的操作系统、Apache、MariaDB、PHP及扩展版本和PHP配置，为Drupal项目提供一致的本地开发和测试环境。

核心功能和特性

• 环境一致性：精确复制Acquia托管环境的关键组件版本，包括OS、Apache、MariaDB、PHP及其扩展
• 配置自动获取：通过getconfig.sh脚本和getconfig.php助手工具，可从指定Acquia主机获取目标配置
• 版本扩展支持：支持添加新的PHP版本，只需更新配置文件即可扩展环境兼容性
• 构建验证机制：Dockerfile构建过程包含配置验证步骤，确保扩展和PHP配置与预期一致，不一致时会输出差异信息

使用场景和适用范围

适用于需要在本地模拟Acquia生产环境进行开发、测试和调试的Drupal项目团队，确保开发环境与生产环境高度一致，减少因环境差异导致的部署问题。

使用方法和配置说明

快速开始

1. 将项目中的docker-compose.yml文件复制到你的项目目录
2. 根据需求导出或编辑TAG和VERSION环境变量
3. 运行以下命令启动环境：

   bash
   docker-compose up
   

更新和/或添加PHP版本

该镜像使用getconfig.sh脚本和getconfig.php助手工具来确定指定主机的目标配置。若需添加新PHP版本，请按以下步骤操作：

1. 添加PHP版本支持：

   • 在getconfig/getconfig.sh文件中，将新PHP版本添加到SUPPORTED_PHP列表
   • 在Jenkinsfile的测试版本列表中添加该版本

2. 执行配置获取：

   bash
   # 下载getconfig.php助手工具
   curl -Lso getconfig/getconfig.php https://raw.githubusercontent.com/drydockcloud/tools-php-getconfig/master/getconfig.php
   
   # 设置目标Acquia主机
   export HOST=mysite@mysite.full.domain
   
   # 运行配置获取脚本
   ./getconfig/getconfig.sh
   

3. 配置验证与构建：

   • 完成后，检查配置差异并尝试构建各Dockerfile
   • Dockerfile构建过程的最后3行RUN指令包含测试步骤，用于验证扩展和PHP配置是否与预期一致。若存在差异，构建将输出差异信息并失败
   • 若构建失败，需更新Dockerfile以整合新的/修改的扩展版本及相关依赖包

环境变量说明

• TAG：镜像标签，用于指定特定版本
• VERSION：组件版本号，控制环境中各软件的版本
• HOST：目标Acquia主机地址，格式为[站点名]@[完整域名]，用于获取远程配置