Simple Acquia Vagrant Box

A super simple Vagrant box for your Acquia project.

NOTE: You only need to download the project files if you want to customise the configuration.

Usage

1. Install VirtualBox & Vagrant

2. Add the following to your settings.php file:

/**
 * Include vagrant settings.
 */
$vagrant_settings = '/home/vagrant/vagrant.settings.php';
if (file_exists($vagrant_settings)) {
  include $vagrant_settings;
}

IMPORTANT: You must add these lines to settings.php after the $databases. Normally, you add these lines to the end of your settings.php file.

3. In your Acquia project root run $ vagrant init 8thom/acquia-php_5.6; vagrant up

-or-

$ vagrant init 8thom/acquia-php_5.5; vagrant up for PHP 5.5

All available boxes -- https://atlas.hashicorp.com/8thom

Default configuration can be found in config.yml

Example

see - https://github.com/thom8/acquia-vagrant-example

Thanks

This would not be possible without geerlingguy's awesome project Acquia Cloud VM.

If you like this I encourage you to support him by buying his book Ansible for DevOps.

Customi(s|z)ation

Copy config.yml to your Acquia project root.

$ wget https://raw.githubusercontent.com/thom8/acquia-vagrant/master/config.yml

If you modify any config used by Ansible provisioning you may also want to update "vagrantup_provision" to true so these modifications are applied during vagrant up.

As the base boxes are a preprovisioned version of Acquia Cloud VM customisation is the same. Please follow instructions on the project page https://github.com/geerlingguy/acquia-cloud-vm There are only a few minor differences which I'll detail below.

Database importing

A database import can be configured to run on vagrant up.

File import

Update config.yml to include --

db_import_type: file
db_import_source: [path to sql dump]

The path is relative to the Acquia project root.

drush sql-sync

Requires

• Setting up SSH agent forwarding
• Adding drush aliases to your project

1. Update ~/.ssh/config to include the following.

Host 127.0.0.1
  ForwardAgent          yes

*Run ssh-add -L inside the vagrant box to test.

2. Add your Acquia drush aliases to your project.

Download your aliases -- https://docs.acquia.com/cloud/drush-aliases Copy [site].aliases.drushrc.php to docroot/sites/all/drush/

3. Update config.yml to include --

db_import_type: sql-sync
db_import_source: [site].[env]

hosts file configuration (DNS)

Requires

• Vagrant Host Updater plugin.

  Installation

  $ vagrant plugin install vagrant-hostsupdater

  The hostname & vhost servername settings in config.yml will be automatically added to /etc/hosts of the host machine.

FAQ

• How does this work?

  The base boxes are a pre-provisioned version of Acquia Cloud VM that is packaged with a custom Vagrantfile with default config set so it can work without any customisation. Ansible is also pre-installed on the box which allows it to reprovision itself, so during provisioning the config.yml file is uploaded to the VM before Ansible is run in local mode. For an example on how provisioning works please see the Example Project

• How does it work without a custom config.yml file?

  There is a default config.yml file in the box so a custom one is not required. An example with default config is included in the project.

• Can I customise the Vagrantfile?

  Sure, the only issue would be a namespace collision with the box Vagrantfile. However, you can use this method to override the default provisioners in the project Vagrantfile.

• Can I customise the provisioning scripts?

  Yep, the current provisioning scripts in "vagrant-include" can be added to your own project and will override the defaults packaged in the box.

• What's an Acquia project root?

  This the the top level directory of an Acquia project which contains the docroot directory.