aheadworks/m24dev-ce

docker-m2dev

镜像概述和主要用途

docker-m2dev是Magento 2开发的基础镜像，仅用于开发环境，切勿用于生产环境。该镜像集成多个服务（nginx、php-fpm、ssh等），内置预安装的Magento 2实例及开发工具，旨在简化开发流程，支持运行Magento CLI脚本，并解决Windows/macOS系统中绑定卷的性能问题。

核心功能和特性

内置组件

• Magento 2实例：预安装Magento 2（可选包含示例数据）
• 服务组件：php-fpm、nginx、crontab
• 开发工具：composer、mhsendmail、python
• 其他服务：SSH服务，便于远程操作和调试

可用标签

• Magento版本：2.4.4+及以上版本
• 功能变体：包含/不包含示例数据（sampledata）
• PHP版本：根据Magento官方系统要求匹配
• 调试支持：包含/不包含XDebug

使用场景和适用范围

适用于Magento 2开发者搭建本地开发环境，尤其适合需要快速部署多服务（Web服务器、PHP、数据库交互）的场景，解决跨平台（Windows/macOS）绑定卷性能问题，支持Magento扩展开发、代码调试及CLI命令运行。

详细使用方法和配置说明

环境变量

可通过docker run的-e参数或docker-compose.yml的environment节点配置以下环境变量：

启动流程

1. 等待MYSQL_HOST指定的MySQL服务器就绪
2. 检查MYSQL_DATABASE中的数据库结构是否正常
3. 若数据库结构异常，导入预保存的数据库dump
4. 更新Magento可配置设置
5. 启动HTTP前端服务和SSH服务器

Docker Compose示例

yaml
version: '3.7'
services:
  db:
    environment:
    - MYSQL_ROOT_PASSWORD=myrootpassword
    - MYSQL_USER=magento
    - MYSQL_PASSWORD=magento
    - MYSQL_DATABASE=magento
    image: mysql:8.0
    volumes:
    - data-db:/var/lib/mysql
  mail:
    image: mailhog/mailhog
    command:
    - -smtp-bind-addr
    - 0.0.0.0:25
    - -ui-bind-addr
    - 0.0.0.0:80
    - -api-bind-addr
    - 0.0.0.0:80
    ports:
    - 1388:80
    user: root
  web:
    image: aheadworks/m24dev-ce:2.4.4-p2-8.1-sampledata
    environment:
    - MAIL_HOST=mail
    - MAGENTO_URL=http://local.magento:1380
    - MAGENTO_TIMEZONE=Pacific/Auckland
    - MAGENTO_DEFAULT_CURRENCY=USD
    - MAGENTO_ADMIN_FIRSTNAME=Admin
    - MAGENTO_ADMIN_LASTNAME=MyStore
    - MAGENTO_ADMIN_EMAIL=amdin@example.com
    - MAGENTO_ADMIN_USERNAME=master
    - MAGENTO_ADMIN_PASSWORD=master123
    - MAGENTO_ROOT=/var/www/html
    - MAGENTO_LANGUAGE=en_GB
    - MYSQL_HOST=db
    - MYSQL_ROOT_PASSWORD=myrootpassword
    - MYSQL_USER=magento
    - MYSQL_PASSWORD=magento
    - MYSQL_DATABASE=magento
    - AUTO_SETUP=1
    - COMPOSER_AUTH=
    - SSH_PASSWORD=pushkin
    ports:
    - '1080:80'
    - '1022:22'
    volumes:
    - data-files:/var/www/html
volumes:
  data-db: null
  data-files: null

贡献指南

基本信息

本仓库使用Multiplicator Python脚本从skeletons目录下的静态资源和Jinja2模板生成多个Dockerfile及构建环境，产物输出至out目录。详情参见https://github.com/m4x0nus/Multiplicator%E3%80%82%60legacy%60%E7%9B%AE%E5%BD%95%E7%94%A8%E4%BA%8E%E5%AD%98%E6%94%BE%E8%BF%87%E6%97%B6%E7%9A%84Magento%E7%89%88%E6%9C%AC%EF%BC%8C%E4%BE%9B%E6%89%8B%E5%8A%A8%E6%9E%84%E5%BB%BA%E5%8F%82%E8%80%83%E3%80%82

添加新Magento版本

1. 编辑config.yaml文件，在out列表中添加新的Magento版本
2. 在Dockerhub添加新标签（将自动构建设为OFF）：
   • https://hub.docker.com/repository/docker/aheadworks/m24dev-ce/builds/edit
   • https://hub.docker.com/repository/docker/aheadworks/m24dev-ee/builds/edit
3. 确保php_deps变量包含待添加的Magento版本系列，如未包含需补充
4. 将更改推送到master分支以触发构建

注意：仅Magento 2.4.4-p2及以上版本支持自动更新，所有旧版Magento仅作参考，需手动更新和构建。