Provisioning Helper for Vagrant. These have been tested only on the vanilla precise32 box provided by the Vagrant people.

• base

  The Base module will set LC_ALL to en_US.UTF-8 and the after it has been loaded

    provision modulename ...
  

  You can also set the timezone with

    set-timezone timezone
  

• build

  This module installs Debians build-essential and sets up ccache.

• apt

  This module updates the package cache every two days or when the /etc/apt/sources.list has been changed. By default it also overwrites the sources to use mirrors, set NO_MIRRORS=1 to prevent this from happending.

  After the module has been loaded you can check if a package is installed

    has packagename
  

  You can also install package(s) unattended

    apt_install packagename ...
  

• pgsql

  This modules sets up PostgreSQL and creates a vagrant user and database.

• mysql

  This modules sets up MySQL and creates a vagrant user and database.

• mongo

  This modules sets up MongoDB.

• wordpress

  This module sets up WordPress.

• ruby

  This module provides helper for installing rubies provided by Ubuntu.

    set-ruby [version]
  

• ruby-essential

  This module provides helper for installing bundles and executing rake tasks.

  Check if a gem is present in /vagrant/Gemfile.lock.

    bundles gemname [Gemfile]
  

  Install bundled gems (w/o doc and production) defined in /vagrant/Gemfile into ~/gems.

    install-bundle [path/to/Gemfile/directory/]
  

  Run rake tasts as vagrant user.

    carry-out [tasks]
  

• ruby-build

  This module provides ruby and will help you installing Rubies. It will installs the ruby-build standalone and setup ccache to speed up compilation time when it's loaded.

  Build a ruby version unconditionally and installs it into /usr/local.

    __ruby version
  

  Build a non-existing ruby version and modifies the PATH globally.

    set-ruby [version]
  

  Install and setup a Ruby

  To build a not already built Ruby you have to add one of the following lines into your provisioning script after you included the ruby module.

    set-ruby 2.0.0-p247 # or
    set-ruby # will use /vagrant/.ruby-version
  

  Speed-Up build times

  It works best across multiple boxes if you sync the cache folder via NFS.

    config.vm.synced_folder '~/.ccache', "/home/vagrant/.ccache", nfs: true, create: true
  

  It is also a good practice to share a RUBY_BUILD_CACHE_PATH across machines.

    config.vm.synced_folder ~/.ruby-build, "/home/vagrant/.ruby-build", nfs: true, create: true
  

• passenger

  This module installs the packaged passenger standalone and provides helper to start Rack applications.

  Start a daemonized passenger on given port in given directory (defaults to port 3000 and and /vagrant).

    on [port] [dirname]
  

• request

  This module includes functions to download resources from a webserver. It will automatically download only resources that have changed after being downloaded during the last provisioning.

  To perform an action after a resource has been download use

    not-modified http://host/database.tar.bz2 || {
        tar -xjf database.tar.bz2 | mysql vagrant
    }
  

To use a shell script for provisioning you have to tell Vagrant about it in your Vagrantfile:

config.vm.provision "shell", path: "provision.sh"

You're advised to submodule this repository into your own:

$ git submodule add https://github.com/boof/vagrant.sh.git .sh

To load the modules just source the generic module into your provisioning script (provision.sh) and use the provision function:

#!/usr/bin/env bash

source /vagrant/.sh/base.sh
set-timezone 'Europe/Berlin'
provision modulename ...

• test if request works as expected
• complete the documentation