- (in progress) 64-bit Windows 10 Pro, Enterprise and Education (1511 November update, Build 10586 or later)
- Mac OS 10.10.3 "Yosemite" or later
- Install docker https://www.docker.com/products/docker#/mac
- Navigate to http://104.236.203.81/devbox-UI/configure-download.html [NOTE ADDRESS CHANGE]
- Select Create New
- Enter your keys (access keys from magento.com my account->marketplace->access keys)
- Generate and Download
- Unzip the file to some directory
- Open terminal and cd to that directory.
- Run ./m2devbox-init.sh in terminal
- Wait until done, it should show something like “To open installed magento go to http://127.0.0.1:32798, admin area: http://127.0.0.1:32798/admin, login: admin, password: admin123”
The configuration page will be in the future integrated into Magento download page flow on magento.com.
Docker assigns a random free port to the container on restart. Run the m2devbox-reset script to reinitialize containers to use the proper port.
Using a script helps us provide a unique name for the containers, which allows you to run multiple sets of containers on one host. The script wraps the commands and also enables containers to run without conflict. In the future, keys will be integrated so there will be no need to enter them.
Why are Apache and PHP in the same container? Docker best practices suggest a container for each component...
Our goal was to create an easy to use development environment, not a production environment. The containers in Magento DevBox should not be used as a model for production use.
Additionally, when we tried separate containers, we encountered stability issues, especially when running multiple sets of containers. Docker is a quickly evolving product but it's not yet sufficiently stable. We are eager to revisit this approach and split the container in components, with option for nginx instead of Apache.
-
MacOS: The shared filesystem is not performant enough. Magento worked too slowly.
That is why we decided to use Unison (a file synchronization tool) to keep the local (inside Docker) web root directory in sync with files in the shared directory. It works quite well, although the initial synchronization takes a few minutes.
We decided not to put Unison on the host machine (which would allow us not to use shared directories at all) to avoid adding dependencies. The MacOS shared filesystem supports notification events, so it can be used directly.
-
Windows: The shared file system does not support notification events.
For this reason, we require a locally installed Unison file synchronization tool, so it can pick up file changes.
Our goal was to provide maximum flexibility. The container supports multiple methods of installing Magento (new installation, from existing local Magento code, or from Magento Enterprise Cloud Edition) and multiple editions (CE, EE, B2B).
For this reason, we do not include Magento files in the Docker image, but instead use Composer to download the files on first start. This is a slower approach than other images you might find on Docker hub; however, it allows us to configure Magento to suit your needs.
We are considering embedding some of the files into the container for a faster start.
We think that you should develop as much as possible in an environment resembling a production configuration. In the majority of cases, a production configuration includes those components (Elasticsearch and RabbitMQ for Magento EE deployments).
This approach allows you to catch early issues related to incompatibility instead of finding those issues at the last moment. During Magento DevBox installation, use Advanced Options to choose which of these components to install.
Contact Piotr Kaminski
@piotrkaminski, please pull changes from my fork.