zsoerenm/magento2-nginx

Magento 2 Docker容器组合

这是一个用于运行Magento 2电商平台的Docker容器组合方案，旨在简化部署流程并适配不同环境需求。

核心功能

• 同时支持开发和生产环境
• 优先使用官方容器及轻量Alpine Linux基础镜像
• 遵循Docker和Magento 2官方最佳实践
• 目标兼容Linux、Mac（未测试）和Windows平台
• 部署步骤简洁，易于上手

包含容器

• PHP: 基于php:7-fpm-alpine的zsoerenm/magento2-php
• MariaDB: mariadb:10.2
• Nginx: 基于nginx:alpine的zsoerenm/magento2-nginx（当前镜像）
• Redis: redis:alpine
• Cron: 基于php:7-fpm-alpine的zsoerenm/magento2-php
• Varnish: 基于cooptilleuls/varnish:4-alpine的zsoerenm/magento2-varnish
• SSL代理: 基于nginx:alpine的zsoerenm/magento2-sslproxy

使用场景

开发环境

推荐仅挂载修改过的代码目录（如app/code、vendor/<特定厂商>）到容器，以提升性能。Linux/Mac用户需确保主机文件组ID为82，符合Magento 2权限要求。

生产环境

建议将源代码复制到容器内，避免主机挂载。采用Magento推荐的流水线部署流程，大幅缩短系统离线时间。

配置说明

环境变量

PHP

可设置Magento后台配置及Redis、数据库参数，示例：

• CONFIG__DEFAULT__GENERAL__STORE_INFORMATION__NAME=Foobar（设置商店名称）
• MYSQL_HOST（数据库主机地址）
• DEFAULT_CACHE_REDIS_SERVER（默认缓存Redis服务器）

数据库

首次运行必填：

• MYSQL_ROOT_PASSWORD、MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD

Web

必填：

• BACKEND_HOST（PHP主机地址）
• SERVER_NAME（容器名称）

SSL代理

必填：

• BACKEND_HOST（Varnish主机地址）
• SERVER_NAME（浏览器访问的域名）

部署示例

开发环境启动

shell
docker-compose up

访问http://localhost/（或SSL代理配置的域名），自动重定向至HTTPS。

全新安装Magento 2

启动容器后访问https://localhost，或通过命令行安装：

bash
docker-compose exec php bin/magento setup:install

（需确保数据库参数正确，并启用HTTPS）

从现有安装迁移

1. 复制配置文件到容器：

   bash
   docker cp ./src/app/etc/env.php $(docker-compose ps -q php):/var/www/html/app/etc/env.php
   docker cp ./src/app/etc/config.php $(docker-compose ps -q php):/var/www/html/app/etc/config.php
   docker-compose exec php chown magento:www-data app/etc/env.php app/etc/config.php
   docker-compose exec php chmod 664 app/etc/env.php app/etc/config.php
   

2. 导入数据库备份：

   bash
   cat backup.sql | docker exec -i $(docker-compose ps -q db) /usr/bin/mysql -u root --password=PASSWORD DATABASE
   

3. 编译依赖：

   bash
   docker-compose exec php bin/magento setup:di:compile
   

数据库备份

Linux/Mac：

bash
docker exec CONTAINER /usr/bin/mysqldump -u root --password=PASSWORD DATABASE > backup.sql

Windows：

bash
docker exec CONTAINER /usr/bin/mysqldump -u root --password=PASSWORD DATABASE | Set-Content backup.sql

从开发到生产环境

1. 导出配置：

   bash
   docker-compose exec php bin/magento app:config:dump
   

2. 复制配置文件到主机：

   bash
   docker cp $(docker-compose ps -q php):/var/www/html/app/etc/config.php ./src/app/etc/config.php
   

3. 构建生产PHP镜像：

   bash
   docker build -f php/Dockerfile -t magento2-php-prod .
   

4. 构建生产Nginx镜像：

   bash
   docker build -f nginx/Dockerfile -t magento2-nginx-prod .
   

5. 启动生产环境：

   bash
   docker-compose up -f prod.docker-compose.yml
   

许可证

本项目采用MIT许可证，Magento 2遵循其官方许可证。