This repository contains the ISC Lab VM generation scripts, based on
LabVM Framework
(automated using qemu
and Packer).
Requirements:
- a modern Linux system;
- basic build tools (make);
- Hashicorp's Packer;
- qemu+kvm;
Download and save a Ubuntu 22.04 Live Server install iso image.
Optionally, create config.local.mk
, copy the variables from
config.sample.mk
and/or framework/config.default.mk
and edit them to your liking.
You might also want to ensure that packer and qemu are properly installed and configured.
The following Makefile goals are available (the build process is usually in this order):
base
: builds a base Ubuntu 22.04 install (required for the VM image);labvm
: builds the Lab VM with all required scripts and config;cloudvm
: builds (fromlabvm
VM) the cloud VM, cleaned up and ready for cloud usage (e.g., AWS, OpenStack).labvm_edit
: easily edit an already build Lab VM (uses the previous image as backing snapshot);labvm_commit
: commits the edited VM back to its backing base;[*]_clean
: removes the generated image(s);ssh
: SSH-es into a running Packer VM;
If packer complains about the output file existing, you must either manually
delete the generated VM from inside TMP_DIR
, or set the DELETE=1
makefile
variable (but be careful):
make DELETE=1 labvm
If you want to keep the install scripts at the end of the provisioning phase,
set the DEBUG
variable. Also check out PAUSE
(it pauses packer,
letting you inspect the VM inside qemu):
make PAUSE=1 DEBUG=1 labvm labvm_edit
Read [https://github.com/cs-pub-ro/labvm-framework|LabVM Framework's] documentation for more lower-level targets and options.