File:Running vagrant share ssh.jpg

2016-05-08T20:07:04Z

Sanijag:

Vagrant

2016-05-08T20:06:24Z

Sanijag:

Author Svea Anijago, TS 66, 08.05.2015

Vagrant is a command line utility that runs the virtual machine without a UI. It is used to manage virtual machines life cycle and to build complete development environments. It is a liberally licensed [https://github.com/mitchellh/vagrant open source project] that is written in [https://en.wikipedia.org/wiki/Ruby_(programming_language) Ruby] and can also be used with other [https://en.wikipedia.org/wiki/Ruby_(programming_language) programming languages] ([https://en.wikipedia.org/wiki/Java_(programming_language) Java], [https://en.wikipedia.org/wiki/C_Sharp_(programming_language) C#], [https://en.wikipedia.org/wiki/Python_(programming_language) Python], [https://en.wikipedia.org/wiki/PHP PHP], [https://en.wikipedia.org/wiki/JavaScript JavaScript]). It was created in January 2010 by Mitchell Hasimoto, who in November 2012 founded [https://en.wikipedia.org/wiki/HashiCorp HashiCorp] to back up Vagrant development full time.

In Vagrant, [https://en.wikipedia.org/wiki/Virtual_machine virtual machines] are provisioned on top of [https://en.wikipedia.org/wiki/VirtualBox VirtualBox], [https://en.wikipedia.org/wiki/VMware VMware], [https://en.wikipedia.org/wiki/Kernel-based_Virtual_Machine KVM], [https://en.wikipedia.org/wiki/Amazon_Web_Services AWS], [https://en.wikipedia.org/wiki/LXC LXC]. To automatically install and configure software on machines, provisioning tools like shell scripts, [https://en.wikipedia.org/wiki/Chef_(software) Chef], [https://en.wikipedia.org/wiki/Salt_(software) Salt], [https://en.wikipedia.org/wiki/Puppet_(software) Puppet] or [https://en.wikipedia.org/wiki/Ansible_(software) Ansible] can be used. From 1.6, Vagrant natively supports [https://en.wikipedia.org/wiki/Docker_(software) Docker] containers, which in some cases can serve as a substitute for a fully virtualized operating system. <ref>Mitchell Hashimoto (2014-05-06). [https://www.hashicorp.com/blog/vagrant-1-6.html "Vagrant 1.6"]. Retrieved 2016-04-29.</ref> <ref>[http://www.linuxjournal.com/content/introducing-vagrant "Introducing Vagrant"]. Linux Journal. 14 November 2012. Retrieved 2016-05-06.</ref>

== Background ==

Vagrantfile <ref>[https://www.vagrantup.com/docs/vagrantfile/ Vagrantfile]. Vagrant Documentation. Retrieved 2016-05-06.</ref> is a very flexible configuration format. It marks the root directory of the project and describes the machine and resources needed to run the project and what software needs to be installed and how to access it. The syntax used in Vagrantfiles is [http://www.ruby-lang.org/en/ Ruby]. One Vagrantfile per project is used and it is supposed to be committed to version control to allow other developers involved in the project to check out the code. The package format for Vagrant environments are boxes<ref>[https://www.vagrantup.com/docs/boxes.html Boxes]. Vagrant Documentation. Retrieved 2016-05-06.</ref> that can be used on any platform that Vagrant supports. Vagrant uses these base images to clone a virtual machine. As a multi-machine environment, Vagrant is able to define and control multiple guest machines per Vagrantfile. The machines work together or are associated with each other.

=== Backwards compatibility ===

Full backwards compatibility<ref>[https://www.vagrantup.com/docs/installation/backwards-compatibility.html Backwards Compatibility] Vagrant Documentation. Retrieved 2016-05-04.</ref> is provided by Vagrant 1.1+ for Vagrant 1.0.x Vagrantfiles that do not use plugins. Backwards compatibility for 1.x is not guaranteed and syntax stability is not certain before 2.0 which is to have stable backwards compatible Vagrantfile format.

== Installing ==
Vagrants latest versions for [https://en.wikipedia.org/wiki/OS_X Mac OS X], [https://en.wikipedia.org/wiki/Microsoft_Windows Windows], [https://en.wikipedia.org/wiki/Debian Debian] and [https://en.wikipedia.org/wiki/CentOS Centos] can be installed by using installation package from their [https://www.vagrantup.com/downloads.html homepage]. There is also possibility to get older version from Vagrants [https://releases.hashicorp.com/vagrant/ releases services]. It will isolate dependencies and their configurations in a single consistent environment. Using single Vagrantfile the whole working environment is installed and configured. <ref>[https://www.vagrantup.com/docs/getting-started/project_setup.html Project Setup]. Vagrant Documentation. Retrieved 2016-02-29.</ref>

To have a fully functioning virtual machine in VirtualBox running [http://releases.ubuntu.com/12.04/ Ubuntu 12.04 LTS 64-bit], following two commands need to be used to place a Vagrantfile to users directory and install virtual environment:

<code>vagrant init hashicorp/precise64</code>

<code>vagrant up</code>

<code>hashicorp/precise64</code> downloads a box named "hashicorp/precise64" from [https://atlas.hashicorp.com/boxes/search HashiCorp's Atlas box catalog] that stores all the host boxes. Boxes can be downloaded from HashiCorp's Atlas or added from a local file, custom URL or other. They are named using username e.g “hashicorp” and box name “precise64” that are separated with slash. Box names can be also specified with URL or local file paths.

Accessing virtual machine is done with [https://en.wikipedia.org/wiki/Secure_Shell SSH] session and user is located in <code>/home/vagrant</code>

<code>vagrant ssh</code>

== Synced Folders ==

Using synced folders <ref>[https://www.vagrantup.com/docs/synced-folders/ Synced Folders]. Vagrant Documentation. Retrieved 2016-04-27.</ref>, files are automatically synced with the guest machine. By default the project directory in Vagrantfile is shared to <code>/vagrant</code> directory on guest machine, that is different than the <code>/home/vagrant</code> where user is located when using <code>vagrant ssh</code>

== Command-line interface ==
All available subcommands <ref>[https://www.vagrantup.com/docs/cli/ Command-line Interface]. Vagrant Documentation. Retrieved 2016-05-05.</ref> are displayed to user running <code>vagrant command</code>

* '''Box'''
<code>vagrant box</code> is used to manage boxes with sub-commands:<code>add, list, remove, update, outdated, repackage</code>.
So that multiple Vagrant environments could use a box, it needs to be added to Vagrant and then stored under specific name with command:
<code>vagrant box add</code>
Current users boxes are stored globally and projects only use the box as an initial image to clone from but do not modify the actual base image, so that using same <code>hashicorp/precise64</code> box and adding files on one project does not affect others.

* '''Connect'''
<code>vagrant connect</code> is used to enable access to shared environments and complements the <code>vagrant share</code> command.

* '''Destroy'''
<code>vagrant destroy</code> command stops the running virtual machine and destroys all resources created during machine creation process.

* '''Global-status'''
<code>vagrant global-status</code> tells the state of all active Vagrant environments in the system for current logged in user.

* '''Halt'''
<code>vagrant halt</code> shuts down the currently running machine that is managed by Vagrant. At first it is attempted to shut the machine down by running guest OS shutdown mechanism, if this is not successful the <code>--</code> force flag is stated and the machine is shut off.

* '''Init'''
<code>vagrant init [box-name] [box-url]</code> initializes current directory to be a Vagrant environment by creating and initial Vagrantfile if it doesn’t already exist. The first argument will prepopulate the <code>config.vm.box</code> and second argument <code>config.vm.box_url</code> setting in the created Vagrantfile.

* '''Login'''
<code>vagrant login</code> command is used to authenticate with the [https://www.vagrantup.com/docs/other/atlas.html HashiCorp’s Atlas server]. If user is not accessing protected boxes or using [https://www.vagrantup.com/docs/share/ Vagrant Share], no login is needed.

* '''Package'''
<code>vagrant package</code> command packages currently running VirtualBox environment into a re-usable box. This can be used with other providers based on the [https://www.vagrantup.com/docs/providers/ providers] implementation and if they support it.

* '''Plugin'''
<code>vagrant plugin</code> is used to manage plugins along with subcommands: <code>install, license, list, update, uninstall</code>.

Installing a plugin from a known gem source with given name, usually from [https://rubygems.org/ RubyGems]:
<code>vagrant plugin install new-plugin</code>

Installing a plugin from a local file source:
<code>vagrant plugin install /path/to/new-plugin.gem</code>

* '''Port'''
<code>vagrant port</code> displays full list of guest ports mapped to the host machine ports. If multi-machine Vagrantfile is used, name of the machine must be specified with
<code>vagrant port my-machine</code>

* '''Powershell'''
<code>vagrant powershell</code> opens a PowerShell prompt into a running Vagrant machine and will only work if the machine supports PowerShell.

* '''Provision'''

<code>vagrant provision</code> runs configured [https://www.vagrantup.com/docs/provisioning/ provisioners] against the running Vagrant managed machine.

* '''RDP'''
<code>vagrant rdp</code> starts RDP client for a remote desktop session with the guest. Typically only Windows Vagrant environments support remote desktop. Raw arguments are passed through to RDP client by appending it after a <code>--</code>:
<code>vagrant rdp -- /span</code> that on Windows will execute <code>mstsc.exe /span config.rdp</code> allowing RDP to span on multiple desktops.

* '''Reload'''
<code>vagrant reload</code> is the equivalent of running <code>vagrant halt</code> followed by <code>vagrant up</code> commands. This is usually required for the changes made in the Vagrantfile to take effect. <code>vagrant reload</code> is needed after making modifications to the Vagrantfile.

* '''Resume'''
<code>vagrant resume</code> resumes a Vagrant machine that has been suspended with <code>vagrant suspend</code> command.

* '''Share'''
<code>vagrant share command</code> loads the Vagrant Share session so that users Vagrant environment can be shared with anyone to enable collaboration directly in users Vagrant environment.

* '''Snapshot'''
<code>vagrant snapshot</code> is used to manage snapshots with guest machine and are recorded a point-in-time state. This is not provided by every provider. Snapshot sub-commands include <code>push, pop, save, restore, list, delete</code>.

* '''SSH'''
<code>vagrant ssh</code> will SSH into a running Vagrant machine and give user access to a shell. An argument after <code>--</code> in command line is passed directly to ssh executable. That allows for example reverse tunneling down into the ssh program. If command runs in the background, it will be terminated almost immediately since when Vagrant executes the command, it is executed within the context of a shell. If shell is exited, all child processes also exit. To prevent this, process needs to be detached from shell.

* '''SSH-config'''
<code>vagrant ssh-config</code> will output valid configuration for an SSH config file to SSH into the running Vagrant machine from ssh directly.

* '''Status'''
<code>vagrant status</code> will tell the state of the machines Vagrant is managing.

* '''Suspend'''
<code>vagrant suspend</code> suspends the guest machine rather than doing a full boot and saves the exact point-in-time state of the machine. This mostly requires extra disk space storing all the contents of RAM in guest machine not host machine or CPU cycles while it is in suspended.

* '''Up'''
<code>vagrant up</code> is the most important command in Vagrants since it creates and configures guest machine as specified in Vagrantfile.

* '''Version'''
<code>vagrant version</code> displays the version of Vagrant that is installed and the latest version of Vagrant that is currently available,for this a network call must be made. <code>vagrant -- version</code> is for checking only the latest version installed.

== Vagrant share ==

<code>vagrant share</code> has three primary modes or features that are not mutually exclusive:
* '''HTTP sharing''' creates a publicly accessible URL endpoint to access [https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol HTTP] server running in Vagrant environment. It is enabled by default when <code>vagrant share</code> is used. Accessing party does not need to have Vagrant installed in order to view. <ref>[https://www.vagrantup.com/docs/share/http.html HTTP Sharing]. Vagrant Documentation. Retrieved 2016-05-06.</ref>

[[File:running_vagrant_share.jpg|thumb|Using HTTP sharing]]

* '''SSH sharing''' allows instant SSH access to used Vagrant environment by anyone by running <code>vagrant connect --ssh</code> on the remote side.<ref>[https://www.vagrantup.com/docs/share/ssh.html SSH Sharing]. Vagrant Documentation. Retrieved 2016-05-08.</ref>
By default SSH sharing is disabled as a security measure. To enable SSH sharing, supply the <code>--ssh</code> flag when calling <code>vagrant share</code>. If SSH sharing is enabled, a brand new key pair for SSH access is generated. Public key portion is automatically inserted to Vagrant machine and private key portion is uploaded to server managing the Vagrant shares. Private key is encrypted using a password that user will be prompted for and that is never transmitted across the network by Vagrant.
When running <code>vagrant share --ssh</code> it will output the name of the share:

[[File:running_vagrant_share_ssh.jpg|thumb|Using SSH sharing]]

After that, anyone can SSH directly to named Vagrant environment by running <code>vagrant connect --ssh NAME</code> where <code>NAME</code> is the name of the previously share output.

[[File:running_vagrant_connect_ssh.jpg|thumb|Accessing someones Vagrant envionment with SSH in terminal]]

The default behavior is that the private key is encrypted, the connecting person will be prompted for the password to decrypt the private key.

* '''General sharing''' allows anyone to access any exposed port of Vagrant environment by running vagrant connect on the remote side.

== Provisioning ==

Provisioners in Vagrant are for automatical software install anf configuration altering. Each provisioner is configured within Vagrantfile using <code>config.vm.provision</code> method call

<pre>
Vagrant.configure("2") do |config|
# ... other configuration

config.vm.provision "shell", inline: "echo hello"
end</pre>

Each provisioner has a type that is used as the first parameter, then follows basic key/value for configuring that specific provisioner. Instead Ruby block for a syntax can also be used.<ref>[https://www.vagrantup.com/docs/provisioning/ Provisioning]. Vagrant Documentation. Retrieved 2016-05-08.</ref>
== See Also ==
* [https://www.vagrantup.com/ Vagrant Homepage]
* [http://docs.ansible.com/ansible/guide_vagrant.html Using Vagrant and Ansible]
* [https://www.howtoforge.com/tutorial/ubuntu-vagrant-install-and-getting-started/ Starting with Vagrant on Ubuntu 14.10 - A Beginner's Guide]

== References ==
{{Reflist}}

[[Category:Operatsioonisüsteemide administreerimine ja sidumine]]

2016-05-08T17:41:26Z

Sanijag: Created page with "Author Svea Anijago, TS 66, 08.05.2015 THIS IS A DRAFT Vagrant is a command line utility that runs the virtual machine without a UI. It is used to manage virtual machines li..."

Author Svea Anijago, TS 66, 08.05.2015

THIS IS A DRAFT

Vagrant is a command line utility that runs the virtual machine without a UI. It is used to manage virtual machines life cycle and to build complete development environments. It is a liberally licensed open source project that is written in Ruby and can also be used with other programming languages (Java, C#, Python, PHP, JavaScript). It was created in January 2010 by Mitchell Hasimoto, who in November 2012 founded HashiCorp to back up Vagrant development full time.

In Vagrant, virtual machines are provisioned on top of VirtualBox, VMware, KVM, AWS, LXC. To automatically install and configure software on machines, provisioning tools like shell scripts, Chef, Salt, Puppet or Ansible can be used. From 1.6, Vagrant natively supports Docker containers, which in some cases can serve as a substitute for a fully virtualized operating system.

== Background ==

Vagrantfile is a very flexible configuration format. It marks the root directory of the project and describes the machine and resources needed to run the project and what software needs to be installed and how to access it. The syntax used in Vagrantfiles is Ruby. One Vagrantfile per project is used and it is supposed to be committed to version control to allow other developers involved in the project to check out the code. The package format for Vagrant environments are boxes that can be used on any platform that Vagrant supports. Vagrant uses these base images to clone a virtual machine. As a multi-machine environment, Vagrant is able to define and control multiple guest machines per Vagrantfile. The machines work together or are associated with each other.

=== Backwards compatibility ===

Full backwards compatibility is provided by Vagrant 1.1+ for Vagrant 1.0.x Vagrantfiles that do not use plugins. Backwards compatibility for 1.x is not guaranteed and syntax stability is not certain before 2.0 which is to have stable backwards compatible Vagrantfile format.

== Installing ==
Vagrants latest versions for Mac OS X, Windows, Debian and Centos can be installed by using installation package from their homepage. There is also possibility to get older version from Vagrants releases service. It will isolate dependencies and their configurations in a single consistent environment. Using single Vagrantfile the whole working environment is installed and configured.

To have a fully functioning virtual machine in VirtualBox running Ubuntu 12.04 LTS 64-bit, following two commands need to be used to place a Vagrantfile to users directory and install virtual environment:

<code>vagrant init hashicorp/precise64</code>

<code>vagrant up</code>

<code>hashicorp/precise64</code> downloads a box named "hashicorp/precise64" from HashiCorp's Atlas box catalog that stores all the host boxes. Boxes can be downloaded from HashiCorp's Atlas or added from a local file, custom URL or other. They are named using username e.g “hashicorp” and box name “precise64” that are separated with slash. Box names can be also specified with URL or local file paths.

Accessing virtual machine is done with SSH session and user is located in <code>/home/vagrant</code>

<code>vagrant ssh</code>

== Synced Folders ==

Using synced folders, files are automatically synced with the guest machine. By default the project directory in Vagrantfile is shared to <code>/vagrant</code> directory on guest machine, that is different than the <code>/home/vagrant</code> where user is located when using <code>vagrant ssh</code>

== Command-line interface ==
All available subcommands are displayed to user running <code>vagrant command</code>

=== Box ===

<code>vagrant box</code> is used to manage(<code> add, list, remove, update, outdated, repackage </code>)boxes.
So that multiple Vagrant environments could use a box, it needs to be added to Vagrant and then stored under specific name with command:
<code>vagrant box add</code>
Current users boxes are stored globally and projects only use the box as an initial image to clone from but do not modify the actual base image, so that using same <code>hashicorp/precise64</code> box and adding files on one project does not affect others.

=== Connect ===
<code>vagrant connect</code> is used to enable access to shared environments and complements the <code>vagrant share</code> command.

=== Destroy ===
<code>vagrant destroy</code> command stops the running virtual machine and destroys all resources created during machine creation process.

=== Global-status ===
<code>vagrant global-status</code> tells the state of all active Vagrant environments in the system for current logged in user.

=== Halt ===

<code>vagrant halt</code> shuts down the currently running machine that is managed by Vagrant. At first it is attempted to shut the machine down by running guest OS shutdown mechanism, if this is not successful the <code>--</code> force flag is stated and the machine is shut off.

=== Init ===

<code>vagrant init [box-name] [box-url]</code> initializes current directory to be a Vagrant environment by creating and initial Vagrantfile if it doesn’t already exist. The first argument will prepopulate the <code>config.vm.box</code> and second argument <code>config.vm.box_url</code> setting in the created Vagrantfile.

=== Login ===

<code>vagrant login</code> command is used to authenticate with the HashiCorp’s Atlas server. If user is not accessing protected boxes or using Vagrant Share, no login is needed.

=== Package ===

<code>vagrant package</code> command packages currently running VirtualBox environment into a re-usable box. This can be used with other providers based on the providers implementation and if they support it.

=== Plugin ===

<code>vagrant plugin</code> is used to manage plugins along with subcommands (<code>install, license, list, update, uninstall</code>).

Installing a plugin from a known gem source with given name, usually from RubyGems:
<code>vagrant plugin install new-plugin</code>

Installing a plugin from a local file source:
<code>vagrant plugin install /path/to/new-plugin.gem</code>

=== Port ===

<code>vagrant port</code> displays full list of guest ports mapped to the host machine ports. If multi-machine Vagrantfile is used, name of the machine must be specified with
<code>vagrant port my-machine</code>

=== Powershell ===

<code>vagrant powershell</code> opens a PowerShell prompt into a running Vagrant machine and will only work if the machine supports PowerShell.

=== Provision ===

<code>vagrant provision</code> runs configured provisioners against the running Vagrant managed machine.

=== RDP ===

<code>vagrant rdp</code> starts RDP client for a remote desktop session with the guest. Typically only Windows Vagrant environments support remote desktop. Raw arguments are passed through to RDP client by appending it after a <code>--</code>:
<code>vagrant rdp -- /span</code> that on Windows will execute <code>mstsc.exe /span config.rdp</code> allowing RDP to span on multiple desktops.

=== Reload ===

<code>vagrant reload</code> is the equivalent of running <code>vagrant halt</code> followed by <code>vagrant up</code> commands. This is usually required for the changes made in the Vagrantfile to take effect. <code>vagrant reload</code> is needed after making modifications to the Vagrantfile.

=== Resume ===

<code>vagrant resume</code> resumes a Vagrant machine that has been suspended with <code>vagrant suspend</code> command.

=== Share ===

<code>vagrant share command</code> loads the Vagrant Share session so that users Vagrant environment can be shared with anyone to enable collaboration directly in users Vagrant environment.

=== Snapshot ===

<code>vagrant snapshot</code> is used to manage snapshots with guest machine and are recorded a point-in-time state. This is not provided by every provider. Snapshot sub-commands include <code>push, pop, save, restore, list, delete</code>.

=== SSH ===

<code>vagrant ssh</code> will SSH into a running Vagrant machine and give user access to a shell. An argument after <code>--</code> in command line is passed directly to ssh executable. That allows for example reverse tunneling down into the ssh program. If command runs in the background, it will be terminated almost immediately since when Vagrant executes the command, it is executed within the context of a shell. If shell is exited, all child processes also exit. To prevent this, process needs to be detached from shell.

=== SSH-config ===

<code>vagrant ssh-config</code> will output valid configuration for an SSH config file to SSH into the running Vagrant machine from ssh directly.

=== Status ===

<code>vagrant status</code> will tell the state of the machines Vagrant is managing.

=== Suspend ===

<code>vagrant suspend</code> suspends the guest machine rather than doing a full boot and saves the exact point-in-time state of the machine. This mostly requires extra disk space storing all the contents of RAM in guest machine not host machine or CPU cycles while it is in suspended.

=== Up ===

<code>vagrant up</code> is the most important command in Vagrants since it creates and configures guest machine as specified in Vagrantfile.

=== Version ===

<code>vagrant version</code> displays the version of Vagrant that is installed and the latest version of Vagrant that is currently available,for this a network call must be made. <code>vagrant -- version</code> is for checking only the latest version installed.

== Vagrant share ==

<code>vagrant share</code> has three primary modes or features that are not mutually exclusive:
* '''HTTP sharing''' creates a publicly accessible URL endpoint to access HTTP server running in Vagrant environment. It is enabled by default when <code>vagrant share</code> is used. Accessing party does not need to have Vagrant installed in order to view.

ADD Screenshot

* '''SSH sharing''' allows instant SSH access to used Vagrant environment by anyone by running <code>vagrant connect --ssh</code> on the remote side. By default SSH sharing is disabled as a security measure. To enable SSH sharing, supply the <code>--ssh</code> flag when calling <code>vagrant share</code>. If SSH sharing is enabled, a brand new key pair for SSH access is generated. Public key portion is automatically inserted to Vagrant machine and private key portion is uploaded to server managing the Vagrant shares. Private key is encrypted using a password that user will be prompted for and that is never transmitted across the network by Vagrant.
When running <code>vagrant share --ssh</code> it will output the name of the share:

ADD Screenshot1 https://www.vagrantup.com/docs/share/ssh.html

After that, anyone can SSH directly to named Vagrant environment by running <code>vagrant connect --ssh NAME</code> where <code>NAME</code> is the name of the previously share output.

ADD Screenshot2

The default behavior is that the private key is encrypted, the connecting person will be prompted for the password to decrypt the private key.

* '''General sharing''' allows anyone to access any exposed port of Vagrant environment by running vagrant connect on the remote side.

== Summary ==

TBA

== Notes ==

Mitchell Hashimoto (2014-05-06). "Vagrant 1.6". Retrieved 2014-06-14.
https://www.vagrantup.com/
https://www.howtoforge.com/tutorial/ubuntu-vagrant-install-and-getting-started/
http://docs.ansible.com/ansible/guide_vagrant.html

[[Category:Operatsioonisüsteemide administreerimine ja sidumine]]