/drupal-dev-vm

Drupal Development VM (for Drupal 6, 7, 8, etc.) using Vagrant + VirtualBox + Ansible

Primary LanguageShell

Drupal VM for BBC Store

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

  • Apache 2.4.x
  • PHP 5.5.x (configurable)
  • MySQL 5.5.x
  • Drush latest release (configurable)
  • Drupal 7.34
  • Optional (installed by default):
    • Memcached
    • XHProf, for profiling your code
    • XDebug, for debugging your code
    • PHPMyAdmin, for accessing databases directly
    • Solr

Quickstart

1 - Install dependencies (VirtualBox, Vagrant, Ansible)

  1. Download and install VirtualBox.
  2. Download and install Vagrant.
  3. [Mac/Linux only] Install Ansible.

Note for Windows users: Ansible will be installed inside the VM, and everything will be configured internally (unlike on Mac/Linux hosts). See JJG-Ansible-Windows for more information.

2 - Build the Virtual Machine

  1. Download this project and put it wherever you want
  2. Get hold of a database dump and save it somewhere
  3. Clone the BBC Store codebase
  4. Open a terminal, cd to this directory (containing the Vagrantfile and this README file)
  5. Edit local.config.yml and: * set vagrant_ip to a unique IP address for your network * set synced_folder to the location of your Drupal docroot directory * set database_dump to the location of your database dump from step 2
  6. Install Ansible Galaxy roles required for this VM: $ sudo ansible-galaxy install -r requirements.txt
  7. Run 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, and point the static ip you assigned to vagrant_ip to local.store.bbc.com.
  2. Open your browser and access https://local.store.bbc.com.

4 - Keep it in sync

Files are kept in sync with a vagrant rsync file share. To start sharing run vagrant rysnc-auto after starting the VM.

5 - Configure solr

  1. Login to the site with an admin account
  2. Navigate to https://local.store.bbc.com/admin/config/search/search_api and hit the "Add server" button
  3. Server name can be anything
  4. Service class should be "Solr service"
  5. Set Solr Path to "/solr/bbcstore"
  6. Save.
  7. Navigate back to https://local.store.bbc.com/admin/config/search/search_api
  8. Click edit next to "BBC Store Index"
  9. Set "Server" to the server name you defined in step 3.
  10. Save.