aligent/magento2-local

Adobe Commerce 的 Docker Compose 设置

版本支持

本仓库通过统一构建系统支持多个Magento和PHP版本。无需修改compose文件或Dockerfile，只需使用环境变量即可轻松切换版本。

切换版本

设置MAGENTO_VERSION环境变量可使用不同版本。所有服务版本均可通过环境变量自定义：

• MAGENTO_VERSION - PHP容器版本（必填）
• MARIADB_VERSION - 数据库版本（默认：10.6）
• OPENSEARCH_VERSION - 搜索引擎版本（默认：2.12.0）
• RABBITMQ_VERSION - 消息队列版本（默认：3.12）
• REDIS_VERSION - 缓存/会话存储版本（默认：7.2）
• MAILPIT_VERSION - 邮件测试工具版本（默认：1.10）
• COMPOSE_PROFILES - 启用可选服务（见下文）

这些均由manta自动生成的.env文件处理。修改此env文件即可轻松更改服务版本，无需新建项目。

GraphQL服务

GraphQL服务仅适用于Magento 2.4.7及以上版本，因为早期版本不支持GraphQL Inspector。

要启用GraphQL服务，将graphql添加到COMPOSE_PROFILES环境变量：

使用Manta

引导式设置

shell
manta init <目录名称>

Manta会提示选择平台和项目，并自动执行初始化流程。

手动设置

1. 克隆compose项目

shell
manta bitbucket clone-infra ~/Documents/takeflight-infra

2. 克隆应用程序

shell
manta bitbucket clone-app --branch take-flight

3. 初始化项目

shell
manta magento init

# 或可选安装应用程序
manta magento init --install

使用docker compose

无需manta cli也可使用模板。

创建新项目

1. 克隆compose项目并切换标签，例如：git switch 2.4.6

2. 将应用程序克隆到src/目录

shell
git clone git@bitbucket.org:aligent/mcloud-partner.git src

3. 启动所有服务

shell
docker compose up -d

4. 安装Composer依赖

shell
docker compose exec php composer install

5. 验证Magento版本

shell
docker compose exec php bin/magento --version

用户指南

待补充（TBC）

工作原理

架构图

!架构图

Traefik

Traefik是应用代理，用于将所有HTTP请求路由到正确的容器。Aligent特定的Traefik服务详情见其仓库。注意：这是Aligent Ubuntu镜像的一部分，应已在您的笔记本电脑上配置。

路由基于PROJECT环境变量，暴露三个HTTP服务：

• web: https://{PROJECT}.aligent.dev
• rabbitmq: https://rabbitmq-{PROJECT}.aligent.dev
• mailhog: https://mail-{PROJECT}.aligent.dev

本地Traefik仪表板可通过[***]

DevOps指南

构建PHP容器镜像

PHP容器使用统一构建系统，支持从单个Dockerfile构建多个Magento和PHP版本。

构建参数

• DOCKER_TAG（必填）：版本标签，格式为X.Y.Z或X.Y.Z-SUFFIX
  • 示例：2.4.8、2.4.8-8.4、2.4.7-8.2、2.4.5-custom
  • 在Docker Hub中定义

版本特定配置

构建系统包含自动配置管理，可：

• 加载适合版本的PHP和PHP-FPM配置
• 删除其他版本的冲突配置
• 支持自定义配置后缀

配置加载顺序

PHP按字母顺序加载配置文件。后续文件会覆盖早期文件的设置：

1. 2.4.8.dev.ini - Magento版本特定（数字优先于字母）
2. 8.4.dev.ini - PHP版本特定
3. dev.ini - 通用基础配置
4. _custom.dev.ini - 自定义后缀（下划线文件在字母数字之后加载）

名称含下划线的文件（如_custom.dev.ini或2.4.8_custom.dev.ini）因字母顺序加载最晚，因此具有最高优先级，可覆盖其他设置。

添加版本特定配置

在以下目录创建文件：docker/php/config/usr/local/etc/php/conf.d/或docker/php/config/usr/local/etc/php-fpm.d/

shell
# Magento版本特定
docker/php/config/usr/local/etc/php/conf.d/2.4.8.dev.ini

# PHP版本特定
docker/php/config/usr/local/etc/php/conf.d/8.4.dev.ini

# 自定义后缀（最高优先级）
docker/php/config/usr/local/etc/php/conf.d/_performance.dev.ini

load-version-config.sh脚本会基于DOCKER_TAG构建参数自动管理激活的配置。

添加对新Magento版本的支持

1. 更新docker/php/docker-bake.hcl中的magento_php_map：

   hcl
   locals {
     magento_php_map = {
       "2.4.9" = "8.4"  # 添加新版本
       "2.4.8" = "8.3"
       # ...
     }
   }
   

2. 如需要，添加版本特定配置文件

3. 使用新标签更新Docker Hub

4. 在Docker Hub触发重建

注意：对于Magento 2.4.7以下版本，仅构建php和debug目标。graphql目标需要Magento 2.4.7及以上版本。旧版本使用extended-legacy组。