spacemacs/layers/+tools/vagrant
Arif Er 00f9ab19ac chore: update copyright headers to 2022
The script used to identify and update the change is added into the GitHub
workflows script directory. A workflow action can be created to trigger the
script to update the headers on the first of every new year. Possibly a task for
a consequent PR.
2022-06-03 17:32:20 +02:00
..
img
packages.el chore: update copyright headers to 2022 2022-06-03 17:32:20 +02:00
README.org [doc] Fix links 2021-04-13 11:38:33 +02:00

Vagrant layer

/TakeV/spacemacs/media/commit/61785c073c872ad1790f33f86693c1c4403a8ba2/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 a t v prefix)
  • Remote editing on Vagrant boxes via Tramp

Install

Layer

To use this configuration layer, add it to your ~/.spacemacs. You will need to add vagrant to the existing dotspacemacs-configuration-layers list in this file.

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.

Key bindings

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