Simula Research Laboratory /
Center for Resilient Networks and Applications /
NorNet
Homepage of Thomas Dreibholz /
Virtual Machine Image Builder and System Installation Scripts
Simula Research Laboratory /
Center for Resilient Networks and Applications /
NorNet
Homepage of Thomas Dreibholz /
Virtual Machine Image Builder and System Installation Scripts
This repository contains Virtual Machine (VM) image building and system installation scripts, to automatically generate freshly installed VM or container images for different projects and purposes, like minimal servers, basic console setups, development environments, as well as full desktop machines. The scripts use Packer (https://www.packer.io).
As part of the VM setup process, it is also possible to set custom boot-splashes and desktop/screen locker/login background images for customisation.
The Virtual Machine Image Builder and System Installation Scripts are released under the GNU General Public Licence (GPL).
The Git repository of the Virtual Machine Image Builder and System Installation Scripts sources can be found at https://github.com/simula/nornet-vmimage-builder-scripts:
git clone https://github.com/simula/nornet-vmimage-builder-scripts vmimage-builder-scripts
cd nornet-vmimage-builder-scripts vmimage-builder-scriptsNote: The repository name “nornet-vmimage-builder-scripts” refers to the NorNet project, since the initial scripts were developed for the purpose of NorNet system installations. However, the scripts are since a long time generic and project-independed. But in order to keep the repository URL as-is, the repository still contains “nornet” in its name.
Contributions:
Issue tracker: https://github.com/simula/nornet-vmimage-builder-scripts/issues. Please submit bug reports, issues, questions, etc. in the issue tracker!
Pull Requests for the Virtual Machine Image Builder and System Installation Scripts: https://github.com/simula/nornet-vmimage-builder-scripts/pulls. Your contributions to the Virtual Machine Image Builder and System Installation Scripts are always welcome!
The following installations of dependencies are necessary:
Packer (get up-to-date version from https://www.packer.io, the Ubuntu-provided package or snap is out-of-date!)
Required Packer plug-ins for the hypervisor, e.g. VirtualBox, QEMU, Proxmox, …
packer plugins install github.com/hashicorp/virtualbox
packer plugins install github.com/hashicorp/proxmox
packer plugins install github.com/hashicorp/qemu
packer plugins install github.com/hashicorp/docker
packer plugins install github.com/hashicorp/vsphere
...
packer plugins installedCMake, ExifTool, Gimp, GraphicsMagick, Noto Fonts, DejaVu Fonts, for building the boot-splash and desktop/screen locker/login background images:
Ubuntu/Debian:
sudo apt-get install -y --no-install-recommends \
cmake fonts-dejavu fonts-noto gimp graphicsmagick libimage-exiftool-perlFedora:
sudo dnf install --setopt=install_weak_deps=False -y \
awk cmake dejavu-sans-fonts gcc google-noto-sans-fonts GraphicsMagick gimp perl-Image-ExifToolFreeBSD:
sudo pkg install -y \
cmake dejavu gimp3-app noto-sans GraphicsMagick p5-Image-ExifToolTake a look at the script make-direct for installing of the system itself (i.e. not building VMs but configuring the system itself):
./make-direct <PROJECT>
To start a VM build, run one the the make-* scripts:
./make-<PROJECT>with <PROJECT> e.g. “minimal”, “basic”, “development”, “kde”, “kde+development”, “hipercontracer”, etc.!
See further details about the different VM hypervisor variants, systems, and projects (choice of packages to install) below!
The VirtualBox images use optimised settings for display, network and storage. Two disk layouts are available: 3-disks (separate disks for /, /home, and swap; recommended) and 1-disk (one disk for everything).
VMs for usage in Proxmox. They are basically like the VirtualBox variant, with the QEMU Guest Agent installed. Two disk layouts are available: 3-disks (separate disks for /, /home, and swap; recommended) and 1-disk (one disk for everything).
The QEMU images use optimised settings for display, network and storage. Two disk layouts are available: 3-disks (separate disks for /, /home, and swap) and 1-disk (one disk for everything). The QEMU images are particularly useful for OpenStack, for which the disk layout should be 1-disk.
VMs for usage in vSphere. They are basically like the VirtualBox variant, with the Open VM Tools installed.
Note: The vSphere support of the scripts is not tested any more!
Containers for usage in Docker.
The following operating systems are currently supported as VM guests:
Details can be found in the directories installer and http.
General settings:
/ and /home, with subvolumes @ and @home/etc/apt/preferences.d/block-snapd.pref!General settings:
/ and /home, with subvolumes @ and @homeGeneral settings:
/ and /homeGeneral settings:
/ and /homeDetails can be found in the directory projects.
The minimal installation for the system with the settings described above. This project is meant mainly for testing purposes. In most cases, you want the Basic project instead!
Provided packages:
Further properties:
/etc/os-release with operating system information existsThe “Basic” installation is based on the Minimal installation.
It must contain the following packages:
The “KDE” installation is based on the Basic installation.
It must contain the following packages:
Further properties:
The “Development” installation is based on the Basic installation.
It must contain the following packages:
It must contain the following libraries and development files:
Further properties:
The “KDE+Development” installation is based on the KDE and Development installation.
Basic for general-purpose server usage, particularly for working with NorNet purposes.
Basic NorNet VMs for general-purpose desktop usage. They base on the NorNet images, with additional KDE desktop.
Basic for general-purpose desktop usage, particularly for working with NEAT. They base on the NorNet-Desktop images, with NEAT packages and build environment.
Features:
$HOME/src. Build dependencies are already installed.Basic for general-purpose desktop usage, particularly for working with RSerPool, based on the KDE+Development installation.
Features:
$HOME/src. Build dependencies are already installed.These are SimulaMet desktop VMs, based on the KDE+Development installation.
Features:
$HOME/src.Basic for general-purpose desktop usage, particularly for working with 5gVINNI. They base on the NorNet images.
