aheadworks/m2dev-ce

docker-m2dev

Magento 2开发基础镜像。

仅用于开发目的

此镜像包含许多在开发阶段有用但在生产环境中极其危险的配置（例如以root用户运行php-fpm）。

为简化开发流程，该镜像内置多个服务（nginx、php-fpm、ssh），可直接运行Magento CLI脚本，并解决Win/Mac系统下绑定挂载卷的性能问题。

贡献指南

基本信息

本仓库使用Multiplicator Python脚本，通过包含静态资源和Jinja2模板的初始目录结构生成多个Dockerfile和构建环境。

初始目录结构位于skeletons目录下，构建产物将输出至out目录。

更多详情参见：https://github.com/m4x0nus/Multiplicator

legacy目录用于存放过时的Magento版本，以便手动构建。

添加新Magento版本

1. 编辑config.yaml文件，在out列表中添加新的Magento版本
2. 确保php_deps变量包含待添加的Magento版本系列，如未列出需补充
3. 将更改推送到master分支以触发构建

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

镜像内容

• 已安装的Magento 2实例（可选带示例数据）
• PHP-fpm
• nginx
• crontab
• composer
• mhsendmail
• python

可用标签：

• Magento版本：2.4.4+
• 带或不带示例数据
• PHP版本：符合[***]
• 带或不带XDebug

环境变量

可通过-e参数或docker-compose.yml的environment节点传递以下变量：

• MAIL_HOST - 邮件服务器主机名，所有邮件将重定向至此
• SSH_PASSWORD - SSH/SFTP服务root用户密码，默认值：root
• MYSQL_HOST - MySQL服务器主机名
• MYSQL_PORT - MySQL服务器端口，默认值：3306
• MYSQL_USER - MySQL用户名
• MYSQL_PASSWORD - MySQL密码
• MYSQL_DATABASE - 要使用的MySQL数据库名
• MAGENTO_URL - Magento访问URL
• MAGENTO_ADMIN_USERNAME - Magento管理员用户名
• MAGENTO_ADMIN_PASSWORD - Magento管理员密码

启动流程

• 等待MYSQL_HOST指定的MySQL服务器
• 检查MYSQL_DATABASE中的数据库结构是否正常
• 如结构异常，导入预保存的数据库备份
• 更新Magento可配置设置
• 启动HTTP前端和SSH服务

示例docker-compose.yml

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=[***]
    - MAGENTO_TIMEZONE=Pacific/Auckland
    - MAGENTO_DEFAULT_CURRENCY=USD
    - MAGENTO_ADMIN_FIRSTNAME=Admin
    - MAGENTO_ADMIN_LASTNAME=MyStore
    - MAGENTO_ADMIN_EMAIL=***
    - 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