loading table of contents...

3.3.4. Configuring Vagrant Based Setup

To install Vagrant and VirtualBox, download the installers with the versions described in the section called “Developer Setup”. Afterwards install VirtualBox first and then Vagrant.

[Note]Note

Make sure that a HOME environment variable is pointing to your users home directory and that the path to Virtualbox is in your PATH variable.

Vagrant Plugins

By default, the CoreMedia configuration depends on the following plugins that you have to install:

  • The vagrant-omnibus plugin will install the specified Chef Client version. The plugins documentation can be found here.

  • The vagrant-ohai plugin will install ohai and set node[ipaddress] to the IP of the correct network adapter, that is 192.168.252.100. The plugins documentation can be found here.

  • The nugrant plugin provides simple configuration overrides on machine, user or project level. The plugins documentation can be found here.

  • The vagrant-berkshelf plugin provides dependency management for cookbooks. Like with Maven, cookbook dependencies are being resolved and downloaded from a central repository. For further details visit the official Berkshelf documentation here. The plugins documentation can be found here. In general, please make sure that the Berkshelf version shipped with your Chef Development Kit installation is supported (refer to known issues and related workarounds at https://github.com/berkshelf/vagrant-berkshelf/issues before contacting CoreMedia Support).

To install the Vagrant plugins, simply call vagrant plugin install PLUGIN-NAME. For example, to prepare your virtualized environment, you need to run the following command:

vagrant plugin install vagrant-omnibus --plugin-version "= 1.4.1"

[Warning]Warning

Please refer to the Vagrantfile for the required plugin versions.

To further improve your development experience with Vagrant, you can choose from the many vagrant plugins, available in the Vagrant ecosystem.

A list of some of the most popular plugins is maintained here. To reduce the turnaround time for provisioning, CoreMedia recommends one of the plugins to manage snapshots, that is, the sahara or the vagrant-vbox-snapshot plugin. With snapshot capabilities, you can reset to the last working state of a complete setup within seconds and rerun the provisioning step.