vagrant.rst
author Oleksandr Gavenko <gavenkoa@gmail.com>
Sun, 04 Mar 2018 12:32:33 +0200
changeset 2237 1223e5073007
parent 2236 15e9cc9e054f
child 2238 a0d98c23cd6b
permissions -rw-r--r--
Managing boxes.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2197
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     1
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     2
=========
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     3
 Vagrant
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     4
=========
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     5
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     6
Changing Vagrant home directory
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     7
===============================
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     8
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     9
Set ``VAGRANT_HOME`` env var, like::
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    10
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    11
  VAGRANT_HOME=d:\srv\vagrant
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    12
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    13
Default is ``~/.vagrant.d`` for Linux and ``%USERPROFILE%\.vagrant.d`` for Windows.
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    14
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    15
https://www.vagrantup.com/docs/other/environmental-variables.html
5ee52f8d25b5 Changing Vagrant home directory.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    16
2237
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    17
Managing boxes
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    18
==============
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    19
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    20
Adding new box from catalog::
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    21
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    22
  $ vagrant box add ubuntu/trusty64
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    23
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    24
Checking for box updates::
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    25
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    26
  $ cd $BOXDIR
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    27
  $ vagrant box outdated
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    28
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    29
Disable checking for update each time you call ``vagrant`` command::
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    30
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    31
  Vagrant.configure("2") do |config|
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    32
    config.vm.box_check_update = false
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    33
  end
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    34
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    35
Download box update::
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    36
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    37
  $ vagrant box update
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    38
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    39
.. note::
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    40
   ``vagrant box update`` does not magicall updates your existing boxes. In just download
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    41
   updated versions. To install new versio you need to destroy and install new boxes::
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    42
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    43
     $ vagrant destroy
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    44
     $ vagrant up
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    45
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    46
To remove box at specific version::
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    47
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    48
  $ vagrant box remove laravel/homestead --box-version 1.1.0
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    49
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    50
https://www.vagrantup.com/docs/cli/box.html
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    51
  Command: ``vagrant box``.
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    52
https://www.vagrantup.com/docs/boxes/versioning.html
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    53
  Box Versioning.
1223e5073007 Managing boxes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2236
diff changeset
    54
2201
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    55
Running individual provisioning scripts
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    56
=======================================
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    57
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    58
You may give name to provisioning script::
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    59
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    60
  Vagrant.configure("2") do |config|
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    61
    config.vm.provision 'user_ssh', type: :shell, privileged: false do |s|
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    62
      ssh_pub_key = File.readlines("#{Dir.home}/.ssh/id_rsa.pub").first.strip
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    63
      s.inline = "echo #{ssh_pub_key} >> /home/$USER/.ssh/authorized_keys"
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    64
    end
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    65
    config.vm.provision 'root_ssh', type: :shell, privileged: true do |s|
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    66
      ssh_pub_key = File.readlines("#{Dir.home}/.ssh/id_rsa.pub").first.strip
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    67
      s.inline = "mkdir /root/.ssh/; echo #{ssh_pub_key} >> /root/.ssh/authorized_keys"
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    68
    end
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    69
    ...
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    70
  end
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    71
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    72
and apply them individually::
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    73
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    74
  vagrant provision --provision-with user_ssh
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    75
  vagrant provision --provision-with root_ssh
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    76
  vagrant provision --provision-with user_ssh,root_ssh
af2d2e117b4e Running individual provisioning scripts.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2197
diff changeset
    77
2236
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    78
Working with Alpine Linux
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    79
=========================
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    80
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    81
Install plugin::
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    82
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    83
  $ vagrant plugin install vagrant-alpine
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    84
  Installing the 'vagrant-alpine' plugin. This can take a few minutes...
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    85
  Installed the plugin 'vagrant-alpine (0.3.0)'!
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    86
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    87
Create Vagrantfile::
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    88
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    89
  $ vagrant init maier/alpine-3.6-x86_64
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    90
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    91
https://app.vagrantup.com/maier/boxes/alpine-3.6-x86_64
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    92
  AlpineLinux v3.6.2 with VirtualBoxGuestAdditions
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    93
https://app.vagrantup.com/maier
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    94
  maier boxes.
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    95
https://github.com/maier/vagrant-alpine
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    96
  Home page of ``vagrant-alpine`` plugin.
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    97
https://app.vagrantup.com/generic/boxes/alpine36
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    98
  Generic box.
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
    99
https://app.vagrantup.com/generic/boxes
15e9cc9e054f Working with Alpine Linux.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2201
diff changeset
   100
  Generic boxes.