Drupal Development VM

For Drupal 6, 7, 8, etc.

This project aims to make spinning up a simple local Drupal test/development environment incredibly quick and easy, and to introduce new developers to the wonderful world of Drupal development on local virtual machines (instead of crufty old MAMP/WAMP-based development).

It will install the following on an Ubuntu 12.04 linux VM:

• Apache 2.2.x
• PHP 5.4.x
• MySQL 5.5.x
• Drush latest release (configurable)
• Drupal 6.x, 7.x, or 8.x.x (configurable)

It should take 5-10 minutes to build or rebuild the VM from scratch on a decent broadband connection.

Customizing the VM

There are a couple places where you can customize the VM for your needs:

• provisioning/vars/main.yml: Contains variables like the VM domain name (where you can access the Drupal site), MySQL configuration, etc.
• drupal.make: Contains configuration for the Drupal core version, modules, and patches that will be downloaded on Drupal's initial installation (more about Drush make files).

If you want to switch from Drupal 8 (default) to Drupal 7 or 6 on the initial install, do the following:

1. Update projects[drupal][version] and core inside the drupal.make file.
2. Update drupal_major_version inside provisioning/vars/main.yml.

TODO

I originally wrote this VM to demonstrate a very simple Ansible playbook for configuring a web server and installing Drupal. I'm now reformatting everything to use Ansible best practices, and to make the VM actually useful for a developer like myself. To that end, I'll be adding in some of the following soon:

• XDebug
• XHProf
• Other useful tools for IDE/debugging/testing integration
• An easy way to mirror your local SSH config into the VM for remote work
• etc.

Quick Start Guide

1 - Install dependencies (VirtualBox, Vagrant, Ansible)

1. Download and install VirtualBox.
2. Download and install Vagrant.
3. [Mac/Linux only] Install Ansible.
4. Install Ansible Galaxy roles required for this VM: $ ansible-galaxy install geerlingguy.git geerlingguy.apache geerlingguy.mysql geerlingguy.php geerlingguy.php-mysql geerlingguy.composer geerlingguy.drush

Note for Windows users: This guide assumes you're on a Mac or Linux host. Windows support may be added when I get a little more time; the main difference is Ansible needs to be bootstrapped from within the VM after it's created. See JJG-Ansible-Windows for more information.

2 - Build the Virtual Machine

1. Download this project and put it wherever you want.
2. Open Terminal, cd to this directory (containing the Vagrantfile and this REAMDE file).
3. Type in vagrant up, and let Vagrant do its magic.

Note: If there are any errors during the course of running vagrant up, and it drops you back to your command prompt, just run vagrant provision to continue building the VM from where you left off. If there are still errors after doing this a few times, post an issue to this project's issue queue on GitHub with the error.

3 - Configure your host machine to access the VM.

1. Edit your hosts file, adding the line 192.168.88.88 drupaltest.dev so you can connect to the VM.
2. Open your browser and access http://drupaltest.dev/.

Notes

• To shut down the virtual machine, enter vagrant halt in the Terminal in the same folder that has the Vagrantfile. To destroy it completely (if you want to save a little disk space, or want to rebuild it from scratch with vagrant up again), type in vagrant destroy.
• You can change the installed version of Drupal or drush, or any other configuration options, by editing the variables within vars/main.yml.
• Find out more about local development with Vagrant + VirtualBox + Ansible in this presentation: Local Development Environments - Vagrant, VirtualBox and Ansible.
• Learn about how Ansible can accelerate your ability to innovate and manage your infrastructure by reading Ansible for DevOps.

About the Author

Jeff Geerling, owner of Midwestern Mac, LLC, created this project in 2014 so he could accelerate his Drupal core and contrib development workflow. This project, and others like it, are also featured as examples in Jeff's book, Ansible for DevOps.