Awesome

Magento 2 Docker images for extension testing

This repository builds Docker images that can be used to run Magento unit/integration/browser tests for your Magento 2 extensions. It contains a complete Magento 2 installation with all configuration done so you can start testing right away.

The goal of this repository was to build an easy to use image that needs no configuration and has everything on board and limit the amount of configuration as much as possible.

The base for this image is srcoder/development-php, which provides an environment that is compatible with Magento. It has Composer, Imagemagick, Blackfire and more out of the box.

On top of that MySQL is installed as it is required as Magento does a mysqldump when running integration tests. As of Magento 2.4 Elasticsearch is also a requirement so we're also installing that. After this Magento is downloaded and installed.

Usage

The images can be found at the Docker Hub: https://hub.docker.com/r/michielgerritsen/magento-project-community-edition, you can choose between all Magento community versions and the compatible PHP versions. For each combination there is also an image with the -sample-data suffix with the Magento sample data installed.

Docker CLI

docker run -d --rm \
    --name=magento \
    -p 1234:80 \
    -p 3307:3306 \
    -e URL=http://localhost:1234/ \
    -e FLAT_TABLES=false \
    michielgerritsen/magento-project-community-edition:php74-fpm-magento2.4.2

Docker Compose

version: '3'
services:
  magento:
    container_name: magento
    image: michielgerritsen/magento-project-community-edition:php74-fpm-magento2.4.2
    ports:
      - 1234:80
      - 3307:3306
    environment:
      - URL=http://localhost:1234/
      - FLAT_TABLES=false

Parameters

These are all optional and only required when you want to run the container to access the web interface.

Commands

There are a few special command that you can run.

Note: you need to have the container started before running any of these commands.

How to use in your own project

In theory this can be used in any pipeline, but I've only integrated this in Github Actions at this moment.

Github Actions

In the examples folder you can find 2 examples for integration and unit tests. View the readme.md to see how you can start with this in your own project (hint: copy 2 files, add the composer name of your package and you are good to go).

Thanks

Special thanks to Fooman for providing a Magento 2 mirror that does not requires any authentication:

• https://store.fooman.co.nz/blog/no-authentication-needed-magento-2-mirror.html

Version matrix