OpenShift Virtualization (CNV)

Git path: charts/all/cnv-example/

Red Hat OpenShift Virtualization (KubeVirt) runs virtual machines alongside containers. This platform ships a workshop example VM and a Developer Hub software template for hands-on CNV labs.

Prerequisites

  • Hub workers with nested virtualization (or bare-metal). Many cloud/RHDP worker flavors do not expose nested virt — CSV may stay Pending or VMs fail to start.
  • OLM subscription kubevirt-hyperconverged in namespace openshift-cnv via operators-platform chart (hub only, sync-wave 1–2).

What ships

Resource Purpose
operators-platform kubevirt-hyperconverged Subscription + HyperConverged CR on hub
Example VM workshop-cnv-demo Cirros-based demo in cnv-workshop namespace (cnv-example chart)
Software template CNV VM Workshop Scaffolds VM manifests into user Gitea org

The example VM uses cloud-init with user cirros for console login (see charts/all/cnv-example/templates/all.yaml).

Software template

CNV VM Workshop (docs/assets/backstage/software-templates/cnv-vm-workshop/) publishes VM YAML to Gitea and registers a catalog Component. Form fields: name, owner, hub apps domain, memory, vCPU, guest username/password. Optional Argo CD Application on hub syncs manifests/ from the new repo.

Operator discovery

CNV workloads surface in Developer Hub when catalog entities include:

annotations:
  backstage.io/kubernetes-id: <vm-name>
  backstage.io/kubernetes-namespace: <namespace>
  backstage.io/kubernetes-cluster: hub

KubeVirt CRs (VirtualMachine, DataVolume) are reconciled by the CNV operator — no namespace mesh or ACM placement labels required.

Verify 

oc get csv -n openshift-cnv
oc get kubevirt -n openshift-cnv
oc get hyperconverged -n openshift-cnv
oc get vm -n cnv-workshop
virtctl console workshop-cnv-demo -n cnv-workshop

Workshop htpasswd users (workshop-users IdP) receive view in cnv-workshop via platform-users RoleBindings.

Documentation

Next: Developer Hub → Create → CNV VM Workshop template.