Installation & usage instructions

VirtualBox

Install VirtualBox from https://www.virtualbox.org.

Vagrant

Install Vagrant from https://developer.hashicorp.com/vagrant/downloads for your platform.

Use case 1: build the VM locally

Start the VM:

$ vagrant up

That should perform all building steps and even will run the test with the built images.

Interactive use

On the host machine:

$ vagrant ssh

Destroy the VM and start over

$ vagrant destroy --force
$ vagrant box list
$ vagrant box remove sirepo-vm

Use case 2: load the generated VM

Download a generated .zip archive from GHA artifacts and unpack it to have the file named sirepo-vm.box. Then run the following commands:

$ vagrant box add sirepo-vm sirepo-vm.box
$ vagrant box list
$ vagrant init sirepo-vm sirepo-vm.box
$ vagrant up --no-provision
$ vagrant ssh

Docs

• https://developer.hashicorp.com/vagrant/docs/cli/package
• https://stackoverflow.com/a/20680816/4143531

General notes

https://ctrlnotes.com/vagrant-advanced-examples/#-insert-custom-ssh-public-key-to-the-vm