Provisioning virtual machines on KubeVirt

KubeVirt addresses the needs of development teams that have adopted or want to adopt Kubernetes but possess existing virtual machine (VM) workloads that cannot be easily containerized. This technology provides a unified development platform where developers can build, modify, and deploy applications residing in application containers and VMs in a shared environment. These capabilities support rapid application modernization across the open hybrid cloud.

With orcharhino, you can create a compute resource for KubeVirt so that you can provision and manage virtual machines in Kubernetes using orcharhino.

Prerequisites

Provide the installation medium for the operating systems that you want to use to provision hosts. For more information, see Syncing Repositories in Managing Content.
Provide an activation key for host registration. For more information, see Creating An Activation Key in Managing Content.
You must have cluster-admin permissions for the Kubernetes cluster.
A orcharhino Proxy Server managing a network on the Kubernetes cluster. Ensure that no other DHCP services run on this network to avoid conflicts with orcharhino Proxy Server. For more information about network service configuration for orcharhino Proxy Servers, see Configuring Networking in Provisioning Hosts.

Additional resources

For a list of permissions a non-admin user requires to provision hosts, see permissions required to provision hosts.
You can configure orcharhino to remove the associated virtual machine when you delete a host. For more information, see removing a virtual machine upon host deletion.

Adding a KubeVirt connection to orcharhino Server

Use this procedure to add KubeVirt as a compute resource in orcharhino.

Procedure

Enter the following orcharhino-installer command to enable the KubeVirt plugin for orcharhino:
```
# orcharhino-installer --enable-foreman-plugin-kubevirt
```
Obtain a token to use for HTTP and HTTPs authentication:
1. Log in to the Kubernetes cluster and list the secrets that contain tokens:
  $ kubectl get secrets
2. Obtain the token for your secret:
  $ kubectl get secrets MY_SECRET -o jsonpath='{.data.token}' | base64 -d | xargs
3. Record the token to use later in this procedure.
In the orcharhino management UI, navigate to Infrastructure > Compute Resources, and click Create Compute Resource.
In the Name field, enter a name for the new compute resource.
From the Provider list, select KubeVirt.
In the Description field, enter a description for the compute resource.
In the Hostname field, enter the FQDN, hostname, or IP address of the Kubernetes cluster.
In the API Port field, enter the port number that you want to use for provisioning requests from orcharhino to KubeVirt.
In the Namespace field, enter the user name of the Kubernetes cluster.
In the Token field, enter the bearer token for HTTP and HTTPs authentication.
Optional: In the X509 Certification Authorities field, enter a certificate to enable client certificate authentication for API server calls.

The text and illustrations on this page are licensed by ATIX AG under a Creative Commons Attribution Share Alike 4.0 International ("CC BY-SA 4.0") license. This page also contains text from the official Foreman documentation which uses the same license ("CC BY-SA 4.0").