Glossary

guest cluster / guest Kubernetes cluster

Group of integrated Kubernetes worker machines that run in VMs on top of a Harvester cluster.

You can create RKE1, RKE2, and K3s guest clusters using the Harvester and Rancher interfaces. Creating guest clusters involves pulling images from either the internet or a private registry.

Guest clusters form the main infrastructure for running container workloads. Certain versions of Harvester and Rancher allow you to deploy container workloads directly to Harvester clusters (with some limitations).

guest node / guest cluster node

Kubernetes worker VM that uses guest cluster resources to run container workloads.

Guest nodes are managed through a control plane that controls pod-related activity and maintains the desired cluster state.

Harvester cluster

Group of integrated physical servers (hosts) on which the Harvester hypervisor is installed. These servers collectively manage compute, memory, and storage resources to provide an environment for running VMs.

A three-node cluster is required to fully realize the multi-node features of Harvester, particularly high availability. Certain versions of Harvester allow you to create clusters with two management nodes and one witness node (and optionally, one or more worker nodes). You can also create single-node clusters that support most Harvester features (excluding high availability, multi-replica support, and live migration).

Harvester clusters can be imported into and managed by Rancher. Within the Rancher context, an imported Harvester cluster is known as a “managed cluster” or “downstream user cluster” (often abbreviated to “downstream cluster”). The Rancher term refers to any Kubernetes cluster that is connected to a Rancher server.

Certain versions of Harvester and Rancher allow you to deploy container workloads directly to Harvester clusters (with some limitations). When this experimental feature is enabled, container workloads seamlessly interact with VM workloads.

Harvester hypervisor

Specialized operating system and software stack that runs on a single physical server.

Harvester node

Physical server on which the Harvester hypervisor is installed.

Each node that joins a Harvester cluster must be assigned a role that determines the functions the node can perform within the cluster. All Harvester nodes process data but not all can store data.

Harvester Node Driver

Driver that Rancher uses to provision VMs in a Harvester cluster, and to launch and manage guest Kubernetes clusters on top of those VMs.