This repository contains a build system to create OpenBSD cloud images on Linux machines. The purpose of this approach is to build either generic OpenBSD VM images or Golden Images for your cloud deployment in your devops pipeline.
Most automated build systems provide great support for Linux but mostly not for OpenBSD. Until this changes, this build framework will focus on Linux to allow everyone to automatically build OpenBSD images for their servers.
OpenBSD officially only supports installation via the provided installation media. This framework uses a qemu-based VM approach for the installation process to adhere to that guideline and to minimize surprises.
The following VM providers are supported out-of-the-box:
- azure
- qemu / kvm
This framework provides a Vagrantfile with a defined host system to build the images.
$ vagrant up
$ vagrant ssh
$ cd /vagrant
Build cloud image:
make
Possible arguments:
PROFILE: the OpenBSD profile to build, see belowPROVIDER: the cloud provider to build for, see belowDISKSIZE: image size like10(GB)
Profiles define the basic configuration of the OpenBSD system. They primarily define the installed file sets. There are the following profiles defined:
default: Installs all sets except forcomp(compiler) andgame(games).full: Installs all sets.minimal: Installs onlybaseandman.
List all available profiles:
make profiles
Show current profile:
make profile
Set the profile with the PROFILE variable:
make PROFILE=6.8/minimal
OpenBSD releases new versions every half a year.
The profiles/clone-version.sh script can be used to easily clone an old version for the new one.
In almost all cases, this will just work as OpenBSD generally has a quite stable ecosystem.
Once a new profile is finished, don't forget to update .github/workflows/pipeline.yml to build with the new one.
Also change the default profile in the Makefile to the new version.
Providers define cloud specific configurations of the OpenBSD system. There are the following profiles defined:
azure/default: comes with the Microsoft Azure agent for cloud-init and all basic cloud features, this is what you mostly expect from cloud images.azure/minimal: nothing cloud specific at all, Azure will not know when your VM is even readily bootedazure/native: does not come with the bloated Microsoft Agent but with an own simple set of lightweight tools for painless integration. Read more in the providers/azure/native/README.md.qemu/default: nothing cloud specific at allqemu/dev: same as thedefaultbut sets therootuser password toopenbsd. Meant primarily for local development purposes.
List all available providers:
make providers
Show current provider:
make provider
Set the profile with the PROVIDER variable:
make PROVIDER=qemu/default
To download the OpenBSD file sets, a default mirror is set but can be overriden.
Show current mirror:
make mirror
Set the mirror with the MIRROR variable:
make MIRROR=https://ftp.openbsd.org/pub/OpenBSD/
To run the produced qemu images locally, you can use the provided scripts. For example:
./scripts/run-disk.sh target/dev/qemu/dev/7.1/minimal/disk.qcow2
If you are using the default qemu/dev provider, the root password will be openbsd.
Copyright (c) 2020-2022 Tobias Sarnowski [email protected]
Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.