Installation
KubeVirt is a virtualization add-on to Kubernetes and this guide assumes that a Kubernetes cluster is already installed.
If installed on OKD, the web console is extended for management of virtual machines.
Requirements
A few requirements need to be met before you can begin:
Kubernetes apiserver must have
--allow-privileged=true
in order to run KubeVirt's privileged DaemonSet.kubectl
client utility
Container Runtime Support
KubeVirt is currently supported on the following container runtimes:
docker
crio (with runv)
Other container runtimes, which do not use virtualization features, should work too. However, they are not tested.
Validate Hardware Virtualization Support
Hardware with virtualization support is recommended. You can use virt-host-validate to ensure that your hosts are capable of running virtualization workloads:
Installing KubeVirt on Kubernetes
KubeVirt can be installed using the KubeVirt operator, which manages the lifecycle of all the KubeVirt core components. Below is an example of how to install KubeVirt using an official release.
If hardware virtualization is not available, then a software emulation fallback can be enabled using by setting in the KubeVirt CR spec.configuration.developerConfiguration.useEmulation
to true
as follows:
Add the following to the kubevirt.yaml
file
Note: Prior to release v0.20.0 the condition for the
kubectl wait
command was named "Ready" instead of "Available"Note: Prior to KubeVirt 0.34.2 a ConfigMap called
kubevirt-config
in the install-namespace was used to configure KubeVirt. Since 0.34.2 this method is deprecated. The configmap still has precedence overconfiguration
on the CR exists, but it will not receive future updates and you should migrate any custom configurations tospec.configuration
on the KubeVirt CR.
All new components will be deployed under the kubevirt
namespace:
Installing KubeVirt on OKD
The following SCC needs to be added prior KubeVirt deployment:
Once privileges are granted, the KubeVirt can be deployed as described above.
Web user interface on OKD
No additional steps are required to extend OKD's web console for KubeVirt.
The virtualization extension is automatically enabled when KubeVirt deployment is detected.
From Service Catalog as an APB
You can find KubeVirt in the OKD Service Catalog and install it from there. In order to do that please follow the documentation in the KubeVirt APB repository.
Installing KubeVirt on k3OS
The following configuration needs to be added to all nodes prior KubeVirt deployment:
Once nodes are restarted with this configuration, the KubeVirt can be deployed as described above.
Installing the Daily Developer Builds
KubeVirt releases daily a developer build from current master. One can see when the last release happened by looking at our nightly-build-jobs.
To install the latest developer build, run the following commands:
To find out which commit this build is based on, run:
Experimental ARM64 developer builds
Experimental ARM64 developer builds can be installed like this:
Deploying from Source
See the Developer Getting Started Guide to understand how to build and deploy KubeVirt from source.
Installing network plugins (optional)
KubeVirt alone does not bring any additional network plugins, it just allows user to utilize them. If you want to attach your VMs to multiple networks (Multus CNI) or have full control over L2 (OVS CNI), you need to deploy respective network plugins. For more information, refer to OVS CNI installation guide.
Note: KubeVirt Ansible network playbook installs these plugins by default.
Restricting virt-handler DaemonSet
You can patch the virt-handler
DaemonSet post-deployment to restrict it to a specific subset of nodes with a nodeSelector. For example, to restrict the DaemonSet to only nodes with the "region=primary" label:
Last updated