briteskies/magento-pipelines

Magento 2 Docker（构建流程专用）

镜像概述与主要用途

本镜像集合专为在Bitbucket Pipelines上构建Magento 2项目设计，提供了构建过程所需的完整环境。基于PHP官方Docker镜像（Debian 8 "Jessie"），集成了Magento 2构建必要的依赖组件，支持本地构建调试与Bitbucket Pipelines自动化构建流程。

• 代码仓库：[***]
• Docker Hub：https://hub.docker.com/r/briteskies/magento-2-pipelines-docker/
• 镜像引用格式：briteskies/magento-2-pipelines-docker:7.0-cli（以7.0-cli为例）

当前镜像大小约800MB，未来计划基于Alpine OS重构以减小体积（Alpine基础镜像仅35MB，仍支持apt包管理器）。

核心功能与特性

自动构建机制

Docker Hub配置为在以下情况自动重建镜像：

• 代码仓库（bitbucket.org/briteskies/magento-2-pipelines-docker）推送更新时
• 基础PHP镜像仓库更新时

集成组件

• Elasticsearch：根据PHP版本适配
  • PHP < 7.1：Elasticsearch 2.4.6
  • PHP ≥ 7.1：Elasticsearch 5.6.9
• Composer全局包：
  • deployer/deployer
  • hirak/prestissimo

使用场景与适用范围

• Bitbucket Pipelines中的Magento 2项目自动化构建流程
• 本地Magento 2构建环境调试
• Magento 2项目CI/CD流程集成

使用方法与配置说明

本地构建镜像

bash
docker build -t briteskies/magento-2-pipelines-docker:7.0-cli ./7.0-cli

推送镜像至Docker Hub（可选）

bash
docker login -u 用户名 -p 密码
docker push briteskies/magento-2-pipelines-docker:7.0-cli

本地运行容器调试

常规运行

bash
sudo docker run -it briteskies/magento-2-pipelines-docker:7.0-cli bash

忽略默认入口点运行

bash
docker run -it --entrypoint "/bin/bash" briteskies/magento-2-pipelines-docker:7.0-cli

本地调试Bitbucket Pipelines构建流程

1. 启动构建环境容器（挂载项目目录，设置工作目录与内存限制）：

   bash
   docker run -it --entrypoint="/bin/bash" --volume=/var/www/项目目录:/srv/www --workdir="/srv/www" --memory=2048m briteskies/magento-2-pipelines-docker:7.0-cli
   

2. 启动MySQL容器（另开终端）：

   bash
   docker run -e "MYSQL_ROOT_PASSWORD=root" -e "MYSQL_DATABASE=magento2" -e "MYSQL_USER=magento2" -e "MYSQL_PASSWORD=magento2" mysql:5.7
   

3. 获取MySQL容器IP：

   bash
   docker ps  # 获取MySQL容器名称
   docker inspect 容器名称 | grep IPAddress  # 获取IP地址（如172.17.0.3）
   

4. 准备项目环境：

   bash
   # 重命名env.php避免冲突
   mv app/etc/env.php app/etc/env.php.bak
   # 清除缓存文件
   rm -rf /srv/www/var/cache /srv/www/var/di /srv/www/var/generation /srv/www/var/page_cache
   

5. 执行构建命令：

   • 从项目的bitbucket-pipelines.yml中提取构建命令依次执行
   • 需从Bitbucket项目设置中获取环境变量
   • 跳过bash dev/tools/deployment/install-magento.sh命令
   • 手动安装Magento（使用MySQL容器IP）：

     bash
     php -d memory_limit=2G ./bin/magento setup:install \
       --db-host=172.17.0.3 \
       --db-name=magento2 \
       --db-user=root \
       --db-password=root \
       --base-url=http://localhost/ \
       --admin-firstname=Test \
       --admin-lastname=User \
       --admin-email=test.user@example.org \
       --admin-user=test \
       --admin-password=magento2
     

参考文档

• Bitbucket本地调试Pipeline
• Bitbucket Pipeline本地调试问题

待办事项

• 按Magento版本号而非PHP版本号重组仓库结构