Vagrant CKAN development environment

CKAN Version: 2.3

Requirements

• Vagrant >= 1.6
• Virtualbox

Virtualbox

vagrant up

Add the Vagrant box's IP address to your hosts file:

172.94.43.196   ckan.lo

Docker

• Docker must be installed and working - it only works on Linux hosts

Vagrant supports Docker natively from Version 1.6 on.

You have to add permissions for the vagrant user (uid 1000) to the shared folder ckan-vagrant:

setfacl -R -m u:1000:rwX .

Then you can bring the box up:

vagrant up --provider=docker

To find out the IP Address of the box, use the container name that Vagrant prints out (in my case ckan-vagrant_default_1409916413) with docker inspect:

docker inspect --format '{{ .NetworkSettings.IPAddress }}' ckan-vagrant_default_1409916413

See Switching providers if you work with different providers.

Digitalocean

Install the required Vagrant plugins

vagrant plugin install vagrant-digitalocean
vagrant plugin install vagrant-omnibus

Setup the Digitalocean keys

Copy digitalocean.json.dist to digitalocean.json and add the client id and the API key Uncomment the relevant lines in the Vagrantfile.

Fire it up

vagrant up --provider=digital_ocean

Switching providers

"Vagrant currently allows each machine to be brought up with only a single provider at a time". That means you cannot do vagrant up with virtualbox and then withdigitalocean. Quite a simple fix for that is to rename the .vagrant folder to e.g. .vagrant.digitalocean. Running vagrant up after that will create a new folder that contains the virtualbox specific config and you can switch by renaming the folders.