vagrant.sh

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

Modules

base

The Base module will set LC_ALL to en_US.UTF-8 and the after it has been loaded. It'll also fix NFS issues for you (it creates a vagrant-nfs user) and delete existing bash history.

To load a module
```
  provision modulename ...
```
You can also set the timezone with
```
  set-timezone timezone
```
To run a command as another user
```
  as vagrant "command ..."
```
To check if the system supports a command
```
  can command || apt-install something
```
To set the directory which you'll enter after vagrant ssh
```
  redir [directory(=/vagrant)]
```
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.
apache

This module provides provides helper to install and configure apache.

To install Apache
```
  setup-apache [mpm(=worker)] [DocumentRoot(=/vagrant/public)]
```
To change the DocumentRoot
```
  set-docroot [directory]
```
wordpress

This module sets up (deploys to /vagrant/wordpress if no wp-config.php can be found) WordPress.
drupal

This module sets up (deploys to /vagrant/drupal if no web.config can be found) Drupal.

To install Drupal
```
  install-drupal <version> (e.g. 8.0-alpha12)
```
ruby

This module provides helper for installing rubies provided by Ubuntu.
```
  set-ruby [version]
```
Note: For MRI versions below 1.9 the ruby1.8 packages will be installed. Right now this is 1.8.7. For MRIs after 1.9 the package installed is 1.9.1 which maps to Ruby 1.9.3
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]
```
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(=3000)] [directory(=/vagrant)]
```
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
  }
```

Usage

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/fork/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 ...

TODOs

keep the documentation up to date...
apt-install only if has fails

fork / vagrant.sh

vagrant.sh

Modules

Usage

TODOs

About

Languages