2013-09-03 18:08:28 +00:00
|
|
|
---
|
2013-09-06 16:50:43 +00:00
|
|
|
page_title: "Teardown - Getting Started"
|
2013-09-03 18:08:28 +00:00
|
|
|
sidebar_current: "gettingstarted-teardown"
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Teardown
|
|
|
|
|
|
|
|
|
|
We now have a fully functional virtual machine we can use for basic
|
|
|
|
|
web development. But now let's say it is time to switch gears, maybe work
|
|
|
|
|
on another project, maybe go out to lunch, or maybe just time to go home.
|
|
|
|
|
How do we clean up our development environment?
|
|
|
|
|
|
|
|
|
|
With Vagrant, you _suspend_, _halt_, or _destroy_ the guest machine.
|
|
|
|
|
Each of these options have pros and cons. Choose the method that works
|
|
|
|
|
best for you.
|
|
|
|
|
|
|
|
|
|
**Suspending** the virtual machine by calling `vagrant suspend` will
|
|
|
|
|
save the current running state of the machine and stop it. When you're
|
|
|
|
|
ready to begin working again, just run `vagrant up`, and it will be
|
|
|
|
|
resumed from where you left off. The main benefit of this method is that it
|
|
|
|
|
is super fast, usually taking only 5 to 10 seconds to stop and start your
|
|
|
|
|
work. The downside is that the virtual machine still eats up your disk space,
|
|
|
|
|
and requires even more disk space to store all the state of the virtual
|
|
|
|
|
machine RAM on disk.
|
|
|
|
|
|
|
|
|
|
**Halting** the virtual machine will gracefully shut down the guest
|
|
|
|
|
operating system and power down the guest machine. You can use `vagrant up`
|
|
|
|
|
when you're ready to boot it again. The benefit of this method is that
|
|
|
|
|
it will cleanly shut down your machine, preserving the contents of disk,
|
|
|
|
|
and allowing it to be cleanly started again. The downside is that it'll
|
|
|
|
|
take some extra time to start from a cold boot, and the guest machine
|
|
|
|
|
still consumes disk space.
|
|
|
|
|
|
|
|
|
|
**Destroying** the virtual machine will remove all traces of the guest
|
|
|
|
|
machine from your system. It'll stop the guest machine, power it down,
|
|
|
|
|
and remove all of the guest hard disks. Again, when you're ready to work
|
|
|
|
|
again, just issue a `vagrant up`. The benefit of this is that _no cruft_
|
|
|
|
|
is left on your machine. The disk space and RAM consumed by the guest machine
|
|
|
|
|
is reclaimed and your host machine is left clean. The downside is that
|
|
|
|
|
`vagrant up` to get working again will take some extra time since it
|
|
|
|
|
has to reimport the machine and reprovision it.
|
