Add Vagrantfile for faster interactive dev/test

Signed-off-by: Tim Serong <[email protected]>

.gitignore

@@ -4,5 +4,6 @@
 /dist
 *.swp
 .idea
+.vagrant
 /package/harvester-os/iso/boot/grub2/harvester.cfg
 /package/harvester-os/harvester-release.yaml

README.md

@@ -59,6 +59,28 @@ On the newly installed system, `harvester-installer` remains active
 on the console in order to show the cluster management URL along with
 the current node's hostname and IP address.
 
+## Hacking the Interactive Part of `harvester-installer`
+
+Ordinarily `harvester-installer` needs to be run from a booted ISO
+so it can actually install a system.  But, if you're only working
+on changes to the interactive part of the installer (e.g. adding
+or changing fields, or altering the workflow) and don't actually
+need to perform final installation, the binary can be quickly tested
+using vagrant with vagrant-libvirt.  Here's how:
+
+```sh
+ $ USE_LOCAL_IMAGES=true make build
+ $ vagrant up
+ $ vagrant ssh
+ > sudo DEBUG=true TTY=/dev/tty /vagrant/harvester-installer
+```
+
+Be sure the terminal window you use is fairly tall, or it will bail
+out with "panic: invalid dimensions" after you get past the networking
+screen.  To break out of the installer, hit CTRL-C.  If you rebuild
+the binary it can be sync'd back to a running vagrant box with
+`vagrant rsync`.
+
 ## License
 Copyright (c) 2024 [Rancher Labs, Inc.](http://rancher.com)
 

Vagrantfile

@@ -0,0 +1,95 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# All Vagrant configuration is done below. The "2" in Vagrant.configure
+# configures the configuration version (we support older styles for
+# backwards compatibility). Please don't change it unless you know what
+# you're doing.
+Vagrant.configure("2") do |config|
+  # The most common configuration options are documented and commented below.
+  # For a complete reference, please see the online documentation at
+  # https://docs.vagrantup.com.
+
+  # Every Vagrant development environment requires a box. You can search for
+  # boxes at https://vagrantcloud.com/search.
+  config.vm.box = "opensuse/Leap-15.4.x86_64"
+
+  # Disable automatic box update checking. If you disable this, then
+  # boxes will only be checked for updates when the user runs
+  # `vagrant box outdated`. This is not recommended.
+  # config.vm.box_check_update = false
+
+  # Create a forwarded port mapping which allows access to a specific port
+  # within the machine from a port on the host machine. In the example below,
+  # accessing "localhost:8080" will access port 80 on the guest machine.
+  # NOTE: This will enable public access to the opened port
+  # config.vm.network "forwarded_port", guest: 80, host: 8080
+
+  # Create a forwarded port mapping which allows access to a specific port
+  # within the machine from a port on the host machine and only allow access
+  # via 127.0.0.1 to disable public access
+  # config.vm.network "forwarded_port", guest: 80, host: 8080, host_ip: "127.0.0.1"
+
+  # Create a private network, which allows host-only access to the machine
+  # using a specific IP.
+  # config.vm.network "private_network", ip: "192.168.33.10"
+
+  # Create a public network, which generally matched to bridged network.
+  # Bridged networks make the machine appear as another physical device on
+  # your network.
+  # config.vm.network "public_network"
+
+  # Share an additional folder to the guest VM. The first argument is
+  # the path on the host to the actual folder. The second argument is
+  # the path on the guest to mount the folder. And the optional third
+  # argument is a set of non-required options.
+  # config.vm.synced_folder "../data", "/vagrant_data"
+
+  # Disable the default share of the current code directory. Doing this
+  # provides improved isolation between the vagrant box and your host
+  # by making sure your Vagrantfile isn't accessable to the vagrant box.
+  # If you use this you may want to enable additional shared subfolders as
+  # shown above.
+  # config.vm.synced_folder ".", "/vagrant", disabled: true
+  config.vm.synced_folder "bin", "/vagrant"
+
+  # Provider-specific configuration so you can fine-tune various
+  # backing providers for Vagrant. These expose provider-specific options.
+  # Example for VirtualBox:
+  #
+  # config.vm.provider "virtualbox" do |vb|
+  #   # Display the VirtualBox GUI when booting the machine
+  #   vb.gui = true
+  #
+  #   # Customize the amount of memory on the VM:
+  #   vb.memory = "1024"
+  # end
+  #
+  # View the documentation for the provider you are using for more
+  # information on available options.
+
+  config.vm.provider :libvirt do |libvirt|
+    libvirt.storage :file, :size => '500G'
+  end
+
+  # Enable provisioning with a shell script. Additional provisioners such as
+  # Ansible, Chef, Docker, Puppet and Salt are also available. Please see the
+  # documentation for more information about their specific syntax and use.
+  # config.vm.provision "shell", inline: <<-SHELL
+  #   apt-get update
+  #   apt-get install -y apache2
+  # SHELL
+  config.vm.provision "shell", inline: <<-SHELL
+    zypper ar --no-gpgcheck https://download.opensuse.org/repositories/home:/vcheng:/Packages/15.4/home:vcheng:Packages.repo
+    zypper --gpg-auto-import-keys refresh
+    zypper --non-interactive in yip
+    echo -e '#!/bin/sh\necho "fake $0"' > /usr/local/bin/fake
+    chmod a+x /usr/local/bin/fake
+    for f in /usr/sbin/harv-install /usr/sbin/cos-installer-shutdown ; do
+      ln -s /usr/local/bin/fake $f
+    done
+    echo
+    echo 'Run `vagrant ssh` then `sudo DEBUG=true TTY=/dev/tty /vagrant/harvester-installer` to test'
+    echo
+  SHELL
+end