Docker Magento Alpine
Docker development environment for staging Magento 1 & Magento 2 on Alpine 3.6
The docker containers within this repository were build for development purposes only and should NOT be used in production. This product is licensed under the MIT LICENSE and comes with no warranty, use at your own risk.
Supported tags and respective
Using shared volumes on MacOS with Docker is painfully slow. That is why we use docker-sync for sharing volumes with and between docker containers. While this solution has a slightly longer initial up-time, it makes up for it when the containers are started and initially synced. We also use docker-compose to run our docker containers because of it's simplicity. Sample docker-compose files for Magento 1 and Magento 2 can be found in the dist directory. Similarly, there is a docker-sync.yml file that can be used alongside either configuration. Assuming that your Magento installation lives in public_html of your project folder, and the appropriate docker-compose.yml and docker-sync.yml files are found in the same directory, then you can start docker-sync and run the docker containers using the following sequence of commands:
docker-sync start docker-compose up -d
Shutting them down is just as easy:
docker-compose down docker-sync stop docker-sync clean # Only if not starting again
All docker images, except for the php-cli containers, have the ability to tail their container's relevant logs if the
VERBOSE=true flag is passed as an environmental variable. Passing it to the container is optional since by default
VERBOSE=false. It is explicitly stated within the sample docker-compose.yml file for documentation purposes only. Please also note that you will only be able to see the verbose output of these containers if you run docker-compose without the detach flag, i.e.
Since we build off of the
mysql:5.7 image, the environment variables will look the same. One exeption is that we use
MYSQL_USER_NAME instead of
MYSQL_USER_PASSWORD instead of
MYSQL_PASSWORD. This is for backwards compatibility purposes. A full list of environment variables can be found here.
When NGINX starts, it copies the appropriate configuration file so it can be used. This configuration file is determined by the environment variable below. If no variable is passed then the below value is set.
Building our docker images is easy. We use a simple Makefile to manage building and publishing our docker images. As part of our CI/CD pipeline, we use Travis-CI to build our docker images on every push to the master branch. If the build process is successfull, then those new images will be pushed to docker hub. Please note that pull requests are not built automatically to avoid automated pushes to docker hub. Below are all the commands that are implemented within our build system:
make build_all: build all docker images that are found under src directory
make build <tag>: build specific image by passing the tag name as a parameter
make publish_all: push all docker images that have a folder in src
make publish <tag>: push specific image by passing the tag name as a parameter
Issues / Feature Requests
If any issues come up or any feature are requested, please feel free to open up an issue through Github. For all other inquiries, feel free to email us at firstname.lastname@example.org.