spacemacs/layers/+tools/vagrant/README.org
justbur 6eab954afe Use + instead of ! for layer categories
Helm seems to treat "!" specially in pattern matching, so having a ! in
the pattern string when traversing directories is problematic. This
change fixes #2737, because as far as I can tell "+" has no special
meaning in a helm pattern.

Of course, we can choose a different character, but I'm fond of "+" as
representing "more layers here".
2015-09-11 00:13:51 -04:00

2.5 KiB

Vagrant contribution layer for Spacemacs

/TakeV/spacemacs/media/commit/6eab954afecb4af81aa29916deaa5c1cd332bcb9/layers/+tools/vagrant/img/vagrant.png

Description

This layer adds support for working with Vagrant using vagrant.el and vagrant-tramp.

Features:

  • Manage boxes (under the SPC V prefix)
  • Remote editing on Vagrant boxes via Tramp

Install

Layer

To use this contribution add it to your ~/.spacemacs

(setq-default dotspacemacs-configuration-layers '(ruby vagrant))

Note: Since vagrant files are written in ruby it is recommended to install the ruby layer as well.

Vagrant

Follow the Installing Vagrant and Getting Started guides in Vagrant's documentation.

Testing

If you'd like to test this layer out in a simple way (for example to make sure you have Vagrant configured correctly) there is a Vagrantfile in this directory.

Keybindings

Key Binding Description
SPC V D destroy a box
SPC V e edit the Vagrantfile
SPC V H halt (shut down) a box
SPC V p (re)provision a box that is already up
SPC V r resume a suspended box (you can also use SPC V V for this)
SPC V s view the status of running boxes in the current project
SPC V S suspend a box
SPC V t start a vagrant-tramp-term session - after start, edit files at /vagrant:box_name:filename
SPC V V bring up a Vagrant box