3.7 KiB
| layout | title |
|---|---|
| getting_started | Getting Started - Boxes |
Boxes
After project initialization, the next step is always to setup the base box. Vagrant doesn't create a virtual machine completely from scratch. Instead, it imports a base VM, and builds off of that. This simplifies things greatly for both the Vagrant developers and for the Vagrant users, since they don't have to spend time specifying tedious details such as memory size, hard disk size, network controllers, etc.
The bases that Vagrant builds off are packaged as "boxes," which are basically tar packages in a specific format for Vagrant use. Anybody can create a box, and packaging will be covered specifically in the packaging section.
Getting the Rails Box
We've already packaged a basic box which contains Apache2, Passenger, and MySQL. While provisioning will be covered in the getting started guide, we didn't want to burden you with downloading all the cookbooks for all the servers, so we'll instead cover a more simple case, although the rails box was created completely with Vagrant provisioning.
Vagrant supports adding boxes from both the local filesystem and an HTTP URL. Beginning running the following command so it can begin downloading while box installation is covered in more detail:
{% highlight bash %} $ vagrant box add rails http://files.vagrantup.com/rails.box {% endhighlight %}
Installed boxes are global to the current vagrant installation. This means that once the rails box has been added, it can be used by multiple projects at the same time. Each project uses the box as a base only, so once the project VM is created, modifications can be made without affecting other projects which may use the same box.
Note that the box is given its own name, in this case "rails." This name is used throughout Vagrant to reference that box from this point forward. The URL is only used when adding, but never again. And the filename of the box means nothing to the logical name given. It is simply a coincidence that the filename and logical name are equal in this case.
Removing Boxes
Just as easily as they're added, boxes can be removed as well. The following is an example command to remove a box. Do not run this command if you're following the guide. It is just an example.
{% highlight bash %} $ vagrant box remove my_box {% endhighlight %}
Once a box is removed, no new virtual machines based on that box can be created, since it is completely deleted off the filesystem, but existing virtual machines which have already been spun up will continue to function properly.
Configuring the Project to use the Box
Now that the rails box has been successfully added to the Vagrant system, we need to tell our project to use it as a base. This is done through the Vagrantfile. Open the Vagrantfile and paste the following contents into it. The function of the contents should be self-explanatory:
{% highlight ruby %} Vagrant::Config.run do |config| config.vm.box = "rails" end {% endhighlight %}
Testing the Setup
So far, we've only specified a base. No ports have been forwarded, no custom provisioning
has been done, etc. We literally just have one line of configuration in our Vagrantfile.
But even so, we already have a fully functional virtual machine. You can see for yourself
by running vagrant up which will create the environment. After running vagrant up,
you can SSH in to your virtual machine to prove its running using vagrant ssh. Finally,
when you're finished verifying your work so far, you can destroy everything with a
vagrant down (or you may shut down the virtual machine, its your choice).
{% highlight bash %} $ vagrant up ... $ vagrant ssh ... $ vagrant down ... {% endhighlight %}