Drifter is a framework to help provision developer boxes using Ansible and Vagrant.

• Requirements
• Documentation
• TL;DR;
• Installing Vagrant

• Vagrant >= 1.8.4

You also need a virtualization solution, either one of those :

• Virtualbox >= 4.3
• LXC >= 1.0 & vagrant-lxc >= 1.0.0.alpha.2

Optional dependencies :

• vagrant-hostmanager >= 1.5.0 (will be automatically used if installed, make sure it's at least 1.5.0 if you have it)
• Ansible >= 1.9.0 (if you want to use a different provisioner than the default ansible-local)

You can find the complete documentation on Read The Docs : https://liip-drifter.readthedocs.io/

To install it in your project, simply run the following in your project root :

curl -sS https://raw.githubusercontent.com/liip/drifter/master/install.sh | /bin/bash

This will create a Vagrantfile in your root and a virtualization folder containing configuration option. You now have to follow those two steps :

• edit virtualization/parameters.yml to set parameters related to your project
• edit virtualization/playbook.yml to configure what to install in your box

You now just have to launch your Vagrant box and start hacking :

vagrant up

Beforehand, we highly recommend installing the vagrant-hostmanager plugin so that your /etc/hosts/ file is automatically updated with the correct ip :

vagrant plugin install vagrant-hostmanager

If you are a lucky linux user, you can use the LXC provider to have a much quicker box :

vagrant plugin install vagrant-lxc
vagrant up --provider lxc

Open a termain and run :

sudo apt-get install vagrant vagrant-lxc vagrant-cachier
vagrant plugin install vagrant-hostmanager

Go to https://www.vagrantup.com/downloads.html to download and install the latest Vagrant version.

Then open a terminal and run :

sudo apt-get install lxc redir    # this is needed for LXC provider
vagrant plugin install vagrant-lxc vagrant-cachier vagrant-hostmanager

Go to https://www.vagrantup.com/downloads.html to download and install the latest Vagrant version.

Go to https://www.virtualbox.org/wiki/Downloads to download and install the latest VirtualBox version.

Then open a terminal and run :

vagrant plugin install vagrant-lxc vagrant-cachier vagrant-hostmanager

To be completed.