1.
DRUPAL VM
A VM for Drupal development, built with Vagrant + Ansible
★
#DrupalVM Acquia webinar – Jeff Geerling

2.
DRUPAL VM
• Info: www.drupalvm.com
• Docs: docs.drupalvm.com
• Code: GitHub

3.
DRUPAL VM
geerlingguy, what's the quickest way I can
install a new Drupal site on my computer?

4.
DRUPAL VM
• Docker Quick Start:
1. docker run -d -p 80:80 -p 443:443 --name=drupalvm
--privileged geerlingguy/drupal-vm
2. docker exec drupalvm install-drupal
also: install-drupal [version] (8.4.x, 7.56, etc.)
3. Access http://localhost/

5.
DRUPAL VM
geerlingguy, what if I already have an existing
site but want a really simple local development
environment?

6.
DRUPAL VM
• docker-compose.yml integration:
1. Get your codebase into a web subdirectory
2. Grab Drupal VM's docker-compose.yml
3. docker-compose up -d

7.
DRUPAL VM
geerlingguy, what if I need a really complex and
customized local development environment?

8.
DRUPAL VM
I need Apache Solr. And can I run 3.6, not 6.x.
I need Elasticsearch.
I need Varnish.
I need XDebug.
I need [Blackfire|Tideways|XHProf]
I need PHP 7.2. And 7.1. And 7.0. And 5.6.
I need Nginx and PostgreSQL.
(etc.)

9.
DRUPAL VM
• Vagrant Quick Start:
1. Install VirtualBox and Vagrant
2. Download Drupal VM, customize config.yml
3. vagrant up

10.
DRUPAL VM
(almost) All the things:
http://dashboard.drupalvm.test

11.
HOW DO I BUILD AND
MAINTAIN DRUPAL 8
PROJECTS?

12.
❤

13.
DRUPAL-PROJECT
$ composer create-project drupal-composer/drupal-project:8.x-dev
bacon
--stability dev
--no-interaction

14.
DRUPAL VM
composer require --dev geerlingguy/drupal-vm

15.
PREP THE VM
---
vagrant_hostname: local.bacon.com
drupal_build_composer_project: false
drupal_build_composer: false
drupal_composer_dependencies: []
installed_extras:
- drush
- drupalconsole
- mailhog
- nodejs
- xdebug
- varnish
vm/config.yml
{

16.
PREP DRUPAL PROJECT
ENV['DRUPALVM_PROJECT_ROOT'] = "#{__dir__}"
ENV['DRUPALVM_CONFIG_DIR'] = "vm"
ENV['DRUPALVM_DIR'] = "vendor/geerlingguy/drupal-vm"
# Load Drupal VM's Vagrantfile
load "#{__dir__}/#{ENV['DRUPALVM_DIR']}/Vagrantfile"
Vagrantfile
{

17.
vagrant up

18.
EXAMPLE: BEHAT TESTS

19.
EXAMPLE: BEHAT TESTS
• Step 1: There is no step 1!
• BLT comes preconfigured with Behat tests 😌

20.
EXAMPLE: BEHAT TESTS
• Step 5: Test ALL THE THINGS!
• Create feature files in tests/behat/features
• Example: Examples.feature

21.
EXAMPLE: BEHAT TESTS
Feature: Test DrupalContext
In order to prove Behat is working correctly in Drupal VM
As a developer
I need to run a simple interface test
Scenario: Load a page without Javascript
Given I am on "/"
Then the response status code should be 200

22.
EXAMPLE: BEHAT TESTS
Yay!

23.
WINDOWS
😭

24.
WINDOWS
🤗

25.
WINDOWS
• Use SMB, rsync, or reverse-mount shared folders
• Use WSL/Ubuntu Bash and/or Cmder
• Use Unix line endings
• Read the docs

26.
• (docker)
• Configure ALL THE THINGS in Vagrantfile.local
• Add custom pre/post-provision playbooks
• Test your modules with PAReview.sh
BONUS ROUND!

27.
THANKS!