=========
 Vagrant
=========

Changing Vagrant home directory
===============================

Set ``VAGRANT_HOME`` env var, like::

  VAGRANT_HOME=d:\srv\vagrant

Default is ``~/.vagrant.d`` for Linux and ``%USERPROFILE%\.vagrant.d`` for Windows.

https://www.vagrantup.com/docs/other/environmental-variables.html
  Environmental Variables. ``VAGRANT_HOME``.
https://www.vagrantup.com/docs/vagrantfile/
  Load Order and Merging.

Managing names
==============

Vagrant VM name::

  config.vm.define "NAME"

VirtualBox name::

  config.vm.provider :virtualbox do |vb|
    vb.name = "NAME"
  end

Host name::

  config.vm.hostname = "NAME"

Managing boxes
==============

Adding new box from catalog::

  $ vagrant box add ubuntu/trusty64

Checking for box updates::

  $ cd $BOXDIR
  $ vagrant box outdated

or::

  $ vagrant box outdated --global

Disable checking for update each time you call ``vagrant`` command::

  Vagrant.configure("2") do |config|
    config.vm.box_check_update = false
  end

Download box update::

  $ vagrant box update

.. note::
   ``vagrant box update`` does not magicall updates your existing boxes. In just download
   updated versions. To install new versio you need to destroy and install new boxes::

     $ vagrant destroy
     $ vagrant up

To remove box at specific version::

  $ vagrant box remove laravel/homestead --box-version 1.1.0

To get list of boxes with corresponding versions::

  $ vagrant box list
  $ vagrant global-status

https://www.vagrantup.com/docs/cli/box.html
  Command: ``vagrant box``.
https://www.vagrantup.com/docs/boxes/versioning.html
  Box Versioning.

Managing plugins
================

https://www.vagrantup.com/docs/cli/plugin.html
  Command: ``vagrant plugin``.
https://github.com/hashicorp/vagrant/wiki/Available-Vagrant-Plugins
  List of vagrant plugins.

Debugging Vagrant
=================

Add environment variavle::

  VAGRANT_LOG=warn vagrant ssh
  VAGRANT_LOG=info vagrant ssh
  VAGRANT_LOG=debug vagrant ssh

https://www.vagrantup.com/docs/other/environmental-variables.html
  Environmental Variables. ``VAGRANT_LOG``.

Running individual provisioning scripts
=======================================

You may give name to provisioning script::

  Vagrant.configure("2") do |config|
    config.vm.provision 'user_ssh', type: :shell, privileged: false do |s|
      ssh_pub_key = File.readlines("#{Dir.home}/.ssh/id_rsa.pub").first.strip
      s.inline = "echo #{ssh_pub_key} >> /home/$USER/.ssh/authorized_keys"
    end
    config.vm.provision 'root_ssh', type: :shell, privileged: true do |s|
      ssh_pub_key = File.readlines("#{Dir.home}/.ssh/id_rsa.pub").first.strip
      s.inline = "mkdir /root/.ssh/; echo #{ssh_pub_key} >> /root/.ssh/authorized_keys"
    end
    ...
  end

and apply them individually::

  vagrant provision --provision-with user_ssh
  vagrant provision --provision-with root_ssh
  vagrant provision --provision-with user_ssh,root_ssh

Working with Alpine Linux
=========================

Install plugin::

  $ vagrant plugin install vagrant-alpine
  Installing the 'vagrant-alpine' plugin. This can take a few minutes...
  Installed the plugin 'vagrant-alpine (0.3.0)'!

Create Vagrantfile::

  $ vagrant init maier/alpine-3.6-x86_64

https://app.vagrantup.com/maier/boxes/alpine-3.6-x86_64
  AlpineLinux v3.6.2 with VirtualBoxGuestAdditions
https://app.vagrantup.com/maier
  maier boxes.
https://github.com/maier/vagrant-alpine
  Home page of ``vagrant-alpine`` plugin.
https://app.vagrantup.com/generic/boxes/alpine36
  Generic box.
https://app.vagrantup.com/generic/boxes
  Generic boxes.