About The Project

It's a prepared VM for developing Magento shops. Should be used only on local machine - the project is not intended to be a full-blown Magento virtualization solution.

Dependencies:

• Vagrant
• Ansible

Setup DEV environment

Prepare Vagrant instance

1. clone [email protected]:etaroza/magento-vm.git
2. cd magento-vm
3. put "magento" folder or symlink into magento-vm/magento or symlink there
4. create a .env file for local configuration of how Vagrant should be executed
   • It has to have the following two lines:
     • vagrant_host_port_prefix=X, where X will define the port mapping on host. For examle 2 would make the mapping of nginx 80 to 20080, MySQL 3306 to 23306, Mailcatcher 1080 to 21080
     • vagrant_hostname=X,Y,Z, where X, Y, Z are the hosts the vagrant instance is responsible for. config.vm.hostname will be set with X, and if there are Y, Z specified the hostupdater will be configured as config.hostsupdater.aliases = [X,Y,Z].
5. when provisioning you might want to use provision.sh wrapper script

Accessing Magento inside Vagrant

On the localhost make sure to setup proxying into Vagrant. Here's my boxen nginx config:

server {
  listen 80;
  server_name .<%= @server_name %>;

  location / {
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_redirect off;
    proxy_pass http://<%= @server_name %>:20080;
    proxy_read_timeout 20m;
    proxy_connect_timeout 20m;
  }
}

Here's my .env:

vagrant_host_port_prefix=1
vagrant_hostname=multishop.dev,myshop1.dev,myshop2.dev

So in Vagrantfile there's port mapping defined:

• 20080 => 80 (to access the web server inside Vagrant)
• 23306 => 3306 (to access MySQL inside Vagrant)
• 21080 => 1080 (to access Mailcatcher inside Vagrant)

Troubleshooting

• Make sure you cleanup /etc/hosts so that it doesn't have stale Vagrant host mappings.
• Make sure Ansible env-setup and Vagrant env-setup are present as defined in ./vagrant.sh