KubeVirt Machine Images

This repo facilitates kubevirt machine image build and publishing pipelines.

Pipelines are run weekly at minimum to package each distribution and version with the latest updates. Images can be used via tag by digest in your VirtualMachine definitions. This is recommended for production use.

The CCIO kmi project aims to maintain all published distributions up to date with N-1 Versions. Additional versions may also be maintained where community interest and contributor support allows.

---

Distribution Table

Flavor	Stable	Proposed	Preview	Planned		x86_64	arm64
AlmaLinux OS			X			X	X
Alpine Linux
Amazon Linux			X			X
Arch Linux
CentOS		X				X	X
Debian		X				X	X
Fedora		X				X	X
Fedora CoreOS		X				X	X
FreeBSD			X			X
Neutrino
NixOS				X
OpenBSD
OpenWRT
OPNsense
openSUSE			X			X
PFSense
Rocky Linux			X			X	X
Ubuntu		X				X	X
VyOS			X			X

Image Criteria:

Planned

Planned images represent distributions we hope to, or are actively working to publish and support. Community contributions are always welcome. Always feel free to start here if you want to add a new image to the kmi library!

Preview

Preview images are published without any functionality testing. These images are either under active development, or published for community testing to gauge overall interest for maintenance priority.

Proposed

Proposed images are expected to be reasonably stable. These images are candidates for stable status and will be upgraded to stable after consistent and sustained reliability is observed and any major planned enhancements are finalized.

Stable

Stable images have have achieved consistentcy and reliability under scrutiny for a sustained timeframe. These images also have automated maintenance for required compliance including:

• Metadata
  • Source of image
  • Repository commit digest included
  • Date image was pulled from upstream
  • Validate shasum hashes during build
  • URL to upstream distribution documentation
  • URL to upstream distribution download source
  • Original ULA & Distribution license included
  • Cosign signature
• entrypoint.sh will print any or all required metadata on command
• Image will be within public registry size limits
• Image will be qcow2 format and sparsify optimized
• Where applicable, default packages will include:
  • git
  • vim
  • tmux
  • net-tools
  • screenfetch
  • qemu-guest-agent
• Additional packages and sources will be subject to scrutiny before graduation as a proposed stable candidate
• On boot, qemu-guest-agent will provision ssh keys for accessing the guest from kubernets secret
• Image is published in the approved from scratch ubi micro container
• Image will boot on kubevirt using standardized kmi baseline test definitions
• SELinux / Apparmor / Firewall is in state of compliance with published distro best practices
• cloud-init will configure guest and users via supported cloud-config syntax*
• Basic storage, networking, and OS functionality behaves as expected
• README
  • stateless nat "Try Me" yaml or command
  • living document of common uses and applications for the published image
• Ready for PR to kubevirt/containerdisks upstream catalog**

*cloud-init requirement may be waived on case by case basis **upstream requirement may be waived on case by case basis