armbian/documentation
0
0
Fork 0
mirror of https://github.com/armbian/documentation.git synced 2026-01-06 10:13:36 -08:00
Code Issues Packages Projects Releases Wiki Activity

Update vagrant documentation (#237)

Browse Source 
* Delete warning about issue under Xenial, while we now use Jammy.

* Update vagrant documentation according to current workflow
This commit is contained in:
Daniel Gonçalves
2022-07-19 07:22:41 +02:00
committed by GitHub
parent 98699d19d7
commit c844db3e91
1 changed files with 13 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
docs/Developer-Guide_Using-Vagrant.md
View File

@@ -6,21 +6,30 @@ The following steps are performed on the *host* that runs Vagrant.
### Installing Vagrant and Downloading Armbian
#### Virtualbox Version
First, you'll need to [install Vagrant](https://www.vagrantup.com/downloads.html) on your host box. Then you have to choose if you want to run Virtualbox or Libvirt.
**WARNING:** We'll be using [Virtualbox as a virtualization provider for Vagrant](https://www.vagrantup.com/docs/providers/virtualbox). Virtualbox has [documented issues running Xenial under heavy disk IO](https://bugs.launchpad.net/cloud-images/+bug/1616794). Please make sure your version of Virtualbox is >= 5.1.12 where the issue, ["Storage: fixed a problem with the LsiLogic SCSI controller where requests could be lost with SMP guests"](https://www.virtualbox.org/wiki/Changelog), appears to have been resolved.
#### Virtualbox
First, you'll need to [install Vagrant](https://www.vagrantup.com/downloads.html) on your host box. Next, you'll need to install a plug-in that will enable us to resize the primary storage device. Without it, the default Vagrant images are too small to build Armbian.
[Install Virtualbox](https://www.virtualbox.org/manual/UserManual.html#installation), then you'll need to install a plug-in that will enable us to resize the primary storage device. Without it, the default Vagrant images are too small to build Armbian.
vagrant plugin install vagrant-disksize
#### Libvirt
[Installing libvirt](https://libvirt.org/downloads.html) is a little bit more complex as you have to install an hypervisor too (like KVM/Qemu but others are available). Discussing about which one choosing and how to install it is out of scope. Once you have libvirt and an hypervisor installed, you'll need [vagrant-libvirt](https://github.com/vagrant-libvirt/vagrant-libvirt/blob/master/README.md#installation).
Finally, you need to tell vagrant to use libvirt and not default to Virtualbox.
export VAGRANT_DEFAULT_PROVIDER=libvirt
#### Common steps
Now we'll need to [install git](https://git-scm.com/downloads) and clone the Armbian repo. While this might seem obvious, we rely on it being there when we use Vagrant to bring up our guest-build box.
# Clone the project.
git clone --depth 1 https://github.com/armbian/build
# Make the Vagrant box available. This might take a while but only needs to be done once.
vagrant box add ubuntu/focal64
vagrant box add generic/ubuntu2204
# If the box gets updated by the folks at HashiCorp, we'll want to update our copy too.
# This only needs done once and a while.