Vagrantfile docs started. Provisioning stubbed.

This commit is contained in:
Mitchell Hashimoto 2010-03-02 09:56:12 -08:00
parent ca19180370
commit 8458f9791f
2 changed files with 47 additions and 0 deletions

View File

@ -0,0 +1,6 @@
---
layout: guide
title: User Guide - Provisioning
---
# Provisioning

View File

@ -0,0 +1,41 @@
---
layout: guide
title: User Guide - Vagrantfile
---
# Vagrantfile
The Vagrantfile to Vagrant is just like what the Makefile is to the Make utility.
A single Vagrantfile exists at the root of every project which uses Vagrant, and
it is used to configure the virtual environment which Vagrant manages.
## Vagrantfile Load Order
Vagrant loads many Vagrantfiles whenever it is run, and the order they're loaded
determines the configuration values used. If there
are any configuration conflicts, the more recently loaded configuration
value overwrites the older value. Vagrant loads Vagrantfiles in the following order:
1. Vagrantfile from the gem directory is loaded. This contains all the defaults
and should never be edited.
2. Vagrantfile from the box directory is loaded if a box is specified.
3. Vagrantfile from the project directory is loaded. This is typically the
file that users will be touching.
Therefore, the Vagrantfile in the project directory overwrites any conflicting
configuration from a box which overwrites any conflicting configuration from
the default file.
## Vagrantfile Options
The Vagrantfile has many configurable options. To configure Vagrant, a configure
block must be created, which is passed in the configuration object. A brief example
is embedded below:
{% highlight ruby %}
Vagrant::Config.run do |config|
# Use the config object to do any configuration:
config.vm.box = "my_box"
end
{% endhighlight %}
There are many available configuration options. These are listed below: