Drupal 8 - DLAMP - Vagrant

Description

Vagrant VM To quickly setup local dev environments for Drupal 8. Installs a LAMP environment with Drush and adds XDebug as well. Integrates with Jetbrains PhpStorm to clone a single environment for multipule projects. Can also be used as a standalone vagrant solution to quickly configure a development VM.

This is not designed for use in production environments as the security level is pretty low

Requirements

• Vagrant [http://www.vagrantup.com/downloads.html]
• VirtualBox 4.3.8 [https://www.virtualbox.org/wiki/Download_Old_Builds_4_3]
• Vagrant Plugin vagrant-omnibus

Quick Info

• VM IP: 10.0.0.10
• VM user: vagrant
• VM pass: vagrant
• DB user: root
• DB pass: root

Installation

1. Download and Install Vagrant and VirtualBox.

• Installing Vagrant
• Installing VirtualBox

2. Install the vagrant vagrant-omnibus plugin.

• Run vagrant plugin install vagrant-omnibus from a command line tool. vagrant plugin documentation

3. Download this repository

PhpStorm Setup

1. Within the project you would like to create a dev environment for go to the project settings. File->Settings->Vagrant
2. Set Vagrant Executable to the vagrant run file you installed.

• Windows default: C:\HashiCorp\Vagrant\bin\vagrant.exe
• All other OS's should be where you would expect

3. Set Instance Folder to the directory you downloaded this repository to
4. You will then need to open the Environment Variables config using the button with ... on it
5. Add a variable and name it PROJECT_DIR set the value to the dir you store your projects
6. Add a variable and name it SITE_ALIAS set the value to the uri you want to use locally for the project
7. Close out the settings and go to Tools->Vagrant->Up to start up the VM

Standalone Environment Setup

1. Place this repository as the root of the project.
2. Create a folder Public
3. Inside the new folder create another folder dev.local
4. Place project files in dev.local
5. Run vagrant up from within the project directory tree

Interacting with the VM

• SSH - the first might give you some troubles but the second and third should always work
  • vagrant ssh
  • ssh [email protected]
  • PuTTY
• Database - The environment does not use phpMyAdmin but allows remote root access so that the database can be interacted with through external tools such as MySQL Workbench. You also can just ssh in and work on the database using the command line.
• Environment Variable Changes - You can change certain environment variables easily within the chef-solo provisioner but will be resonsible for maintaining any changes to your local environments. This is considered an advanced feature to this project so you're on your own.

Special Thanks

• Neclimdul
• Emma Jane Westby